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PREFACE 


The information about the Perkin-Eimer Multi-Terminal Monitor 
(MTM) in this manual is written for the MTM user and can also be 
helrful to the system operator and system programmer. 


Chapter 1, which is reorganized, is a general description of the 
MTM system, containing informaticn on MTM system requirements, 
MTM features, and various conventions. Chapter 2 describes ATM 
user commands, and Chapter 3 explains the program development 
commands. Chapter 4& describes batch processing under MIM. 
Charter 5 describes the command substitution system (CSS) and 
includes CSS commands. Chapter 6 describes spooling. 


Appendix A summarizes the MTM user commands. Appendix B is a 
summary of the program development commands. Appendix C 
Summarizes the CSS commands, and Appendix D is an MIM command 
message summarye Appendix £ is a summary of CSS messages, and 
Ronendix F is a Summary of perogram development command messages. 


This manual replaces 329-5951. Revision ROO adds Chapter 3, 
describing the new program development commands. The signon CSS, 
USFRINIT.CSS, is made more flexible. Vertical forms control 
(VFC) is added, and changes are made to several MIM user 
commands. A Help facility enables a user to access information 
about MTM and program development commandse FOr batch 
processing, the SUBMIT cemmand is upgraded, and the batch signon 
requirements are simplified. Global and local variables are 
added tc CSS, requiring four new commands: SFREE, SGLOBAL, 
SLOCAL, and SSET. Also, there is a reserved global variable for 
end of task codes, and there are reserved variables for assigning 
logical units in a program develcpment environment. The SWAIT 
command is also added tc CSS. Logical units can now be 
automatically assigned. 


This revision applies to the OS/32 806.1 software release and 
higher. 
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The following publications can be used in conjunction with this 
manual: 


PUBLICATION 

MANUAL TITLE NUMBER 
CS/32 AIDS User's Guide $29-374 
OS/32 COPY User Guide S$29-676 
OS/32 LINK keference Manual UB-0905 
CS/32 EDIT User Guide 48-008 
OS/32 Multi-Terminal Monitor (MTM) 
System Planning and Operator Reference Manual 48-023 
CS/32 Cperator Feference Manual &8-0390 
OS/32 System Support Utilities 
reference Manual 4u8=-031 
CS/32 Supervisor Call (SVC) 
Reference Manual 43-038 
OS/32 ApDdlication Level Programmer 
Reference Manual 48-039 
32-3it Systems User Documentation Summary 53-003 


For further information on the contents of all Perkin-Elmer 
32-bit manuals, see the 32-8it Systems User Documentation 
Summary. 
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CHAPTER 1 
GENERAL DESCRIPTION 


1-1 INTRODUCTION 


Multi-tercminal monitor (MIM) permits several terminal users to 
share system resources. Each user perceives that a computer is 
at his disposal. 


Concurrent accesses from online terminals is useful during 
application task development because it reduces turnaround tine. 
Other advantages are that concurrent access can be used to extend 


the type of data processing at an installation. Jsing the 
system-supplied interactive software means that editing, task 
development, and documentation can be done simultaneously. 
Furthermore, if the systen-supplied interactive tasks are 


supplemented by user taske (u-tasks)3; eege, customer-written 
tasks, MTM application becomes limitless, supporting a mixture of 
terminal users such as clerks, and software development and 
Operation personnel. 

1-2 MIM OPERATION 

Lixe all general purvose, multi-access, tine sharing systems, MTK 
requires onerations involvement from the installation uSing it. 
This involvement includes those functions that accompany MT™ when 


it is tailored to a specific installation along with dynamic 
functions nerformed when MTM is operating. 


Examples ot the MIM tailoring functions are: 


e Cataloging authorized users 
e ‘fCystem generation (sysgen) 


e Fstablishing an installation's procedures 


Fxamples of dynamic functions are: 


e ‘System console control 
® reripnheral device supervision 


e fposled cutput dissemination 
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Generally, tailoring functions are performed and maintained by 
the custoner’‘s system support group responsible for making 
computing facilities available to system users. Th2 dynamic 
functions are performed by a system operator during system 
operation and are distinct from those functions performed py 
terminal users. 


The system operator can perform all the functions described in 
the OS/32 Operator Reference Manual, together with operator 
functions required to administer MTM. At any time, the system 
operator may be initiating and controlling multiple foreground 
tasks and one background task while operating MIM. 


1-3 USER INFORMATION 


Under MTM control, a terminal user can: 


@e load and execute interactive tasks; 

® subnit nultiple batch job requests; 

@ perform program development; 

® perform program debugging; 

@e create, edit, and manipulate files; 

@e build, modify, and execute command streams; 
® use spooling functions; 

@ communicate with other terminal users; and 


@® communicate with the system operator. 


A terminal user is either interacting with MIM itself, via 
commands, or interacting with tasks supplied with the system or 
develoved by the installation. All of the vendor-supplied 
language translators can be operated as interactive tasks by a 
terminal user. Additionally, a terminal user can use the 
vendcr-supplied support software programs such as: 05/32 Edit, 
OS/32 Copy, and OS/32 AIDS. It is the MTM software that performs 
multiple online accessibility: eege, time sharing, resource 
management, batch scheduling, etc. 


The terminal user can be local or remote. The interactive 
terminals for local users are directly connected to the computer 
and do not require telecomnunication devices. Tateractive 
terminals fOr remote users require connection via 
telecommunication equipment and data communications software. 
Basic data communications supports both dedicated and dial-up 
telecommunication terminals. 
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1-3-1 MIM Devices 


These devices can be used at any local or remote installation: 


@ Video Display Unit (VDU) 5508 
e VEU 1100 

e VDU 1200 

e VIU 1259 

@ VbU 1251 

@e Ferkin-ctlmer SIGMA 19 terminal 
@e *¥32 Teletype 

e “35 Teletype 

@ Nonediting VPU 

e Carousel 


e Carousel 300 and 309 EFC 


1-3.2 Authorization 


The user must be authorized to use MTM facilities. During the 
Signon procedure, the user nust supply an account number and a 
Password that were previously cataloged within an MTM file called 
the authorized user file (AUF). The AUF is updated and 
Maintained by an MTM-supplied task that can be initiated only by 
the system operator. The terminal user can then interact with 
MTM from a terminal. 


1-3-3 Transmitting Messages 

MTM can transmit mesSages between terminal users, between a 
terminal user and the system operator, and from the system 
operator to all or designated terminal uSers. 

1-3-4 Number of Terminal Users 

Rn installation can have up to 64 terminal users or 64 concurrent 


batch streams. The sum of terminal users and batch streams 
Cannot exceed 64. 


“WE=-G43 FOO ROO Ve 


1.4 MTM ENVIRONMENTS 


The MT“ terminal user controls a rsingle task at the terminal and 
has the ability to run jobs through the batch streans. Jsing the 
facilities provided by MTM, the user can load a task, start the 
task, and then interact with the task during its execution. ATM 
provides interactive and batch user environments. 


In an interactive environment, the user has the ability to 
interact with a task executing at the t2rminal. In this 
environment, a dialogue is carried on between the user and MIM. 
MTM waits for the user commands and processes them. 


GOnly one interactive task at a time can be initiated by each ‘TM 
terminal. However, all interactive tasks initiated by «MTF 
terminal users are executed concurrently. Ouring interactive 
task execution, 2 terminal user can direct a command to and 
receive a response from MT™ itself. 


In a hatch environment, a number of jobs are run under a full set 
of automated procedures. Once a batch job is accepted for 
execution, no further interaction takes place with the initiating 
terminal usere Recuests for multiple batch jobs can be submitted 
by a user, and the same terminal can be used to initiate an 
interactive task. 


Unlike interactive tasxs, requests for batch jobs will not 
necessarily be initiated inmtediately to MIM. Instead, batch jobs 
are queued by the system, anit then tne queue of submitted batch 
jJors awaiting execution is serviced by the system. The number of 
batch jobs that can be executing concurrently is specitied by the 
system operator. 


A terminal user can request one or more batch jobs to be run. 
MTM maintains a oauevue of subnitted patch jobs and concurrently 
rrocesses a numrer of batch jons specified during YIM system 
Start~ruD.e A terminal user can monitor the orogress of a batch 
Jor by interrogating the MTM batch queue. The returned status 
111 be either: 


e -wzwaiting execution, or 


e executing. 


It a Job already has completed execution, the returned status 
will be; no jobs found. 
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teed MTM Terminal Modes 


An active terminal is defined to be in one of four terminal 
MOdES. The current mode of the terminal determines which, if 
any, MTM terminal commands can be accepted. Thus, it is 
important for the terminal user to be aware of the current mode 
of the terminal. The user terminal is defined to be in one of 
the following four trodes: 


e Command node: No task is loaded, CSS procedure is not 
executing and S8UILD is not in effect. All nontask-related 
commands are accepted. An "** promot is displayed in this 
mode. 


e Task loaded rode: The task was loaded but was not started, or 
is paused. An "“*" prompt is displayed in this node. 


e Task executing mode: A tas* was started and is executing. If 


Started from CSS, CSS mode is suspended. A “=-" prompt is 
displayed in this mode. If an interactive task was started 
and a data input is requested by the task, then a “>" prompt 


is displayed to the terminal user. 


e CSS mode: A CSS vrocedure is being built or executed. A “Ne 
Erompt is displayed ir this mode. When CSS terminates, the 
terminal returns to command mode and a"*" prompt is output. 
When a CSS precedure is being built, a “8>" prompt is 
displayed. 


1-4.1-1 Interactive Task to Terminal Mode 


When a task issues an SVC1 I/0 operation to an active terminal 
that is in task executing mcde, MT™M treats the I/0 as a wait 
operetion.e. This is cf no concern tor tasks that do SVC1 wait 
I/O. HYowever, users with tasks that issue SVC1 proceed I/O (read 
or write) should be aware that MTM suspends the task until the 
I/f is completed. Then MT™M posts an SVC1 proceed I/O completion 
trary on the task‘s task aqueve and allows the task to continue. 
Ceonmrletion trar posting occurs only if the appropriate bit is set 
in the TSd. 


1-5 LOADING A TASK 


The dynamic nature of OS/32 memory management guarantees loading 
of a task irrespective of its size unless the task is greater 
than the available task memory. If not enough memory is free t9 
load a task, then some other task is temporarily rolled out if 
roll support is included in the operating system at sysgen time. 
If MTM is svsgened with roll influence enabled, then MIM 
cortinually monitors the state of the roll queve to ensure that 
relled out tasks are given the opportunity to be rolled back in. 
MT™ ensures equity for all its terminal operators by assigning 
all the interactive tasks an equal priority. Tfatch tasks can 
have user-essigned pricrities. 
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1.6 MIM SPECIAL FEATURES 

The following features are designed to nake MTM easier ani more 
efficient to use: 

e Command substitution system (CSS) 

@ Yelp facility 

e Proaram development commands 

® Spooling 

e Security and access pretection cf disks 


® ‘Signon CSS 


1-6-1 Command Substitution Systea (CSS) 


A terminal user can build a command file on a disk. Once built, 
a simple directive to MT“M will cause MTM to obtain its directives 
from the command file. When invoking the command file, the 
terminal user can supgely parameters to the command file that can 
be used to dynamically modify command execution. Therefore, a 
Single terntinal indut can easily initiate complex operations. 


1-6.2 The Help Facility 

The Help facility proviies a user »2nline access to documentation 

for MTM and program developnent commands. This information is 

obtained by entering the HELP command. 

1-623 Program Development Commands 

The program development commands are an integrated set of 

standard CSS procedures that perform two najor functions: 

@® maintain information that remains constant throughout a 
development efforts; and 

® keen files current throughout a development effort in terms of 


checkins source, object, ani image modules to enSure that 
their dates are current. 


1-6 48-043 FOO x00 


1-6-4 Spooling 


Both input and output spooling are provided for terminal users. 
Tasks never need to pe delayed awaiting card readers, card 
Punching, or line printing because a batch job can be submitted 
via the Spocler. The job runs unattended and output goes to the 
Spocler. 


1-6.-& Security and Access Frotection of Disks 

Privately owned disks can be marked on restricted by the system 
operator ¢+o offer an MTs user ccmplete Security and access 
protection of files. The owner of the disk can restrict or 
enarle access of the disk to other MIM users, the system 
operator, and non-MTM tasks. 

1-6-6 Signon CSS 

MTM uSers can build a special CSS file, USERINIT.CSS, within 
their private accounts. The CSS file can contain commands to 
load and start a terminal session, assign logical units, and 
specify a language environment. At signon time, MIM searches all 
online disks within the user's private account for the file 
USERINIT.CSS and automatically executes it. 

1.7 CONVENTIONS 

These conventions used by LIM are detailed in the following 
sections: 

e Fromst conventions 

e Terninal corventions 

e Command conventions 


e Statement eyntax conventicns 


e File conventions 


4127-1 Prompt Conventions 
A prompt is output to a terminal device to indicate that the MTM 


system is ready to accefrt input from the user. The prompts 
displayed on the terminal devices are shown in Table 1-1. 
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TABLE 1-1 MIM PROMPT CONVENTIONS 


| PROMPT 


Vv 


ay 
UV 


ay CORT <TD ate Gee chem copes SEN Se ee OE nD SR ee ee ee i ee “en 


wae 22 we GD eb OE OF ew aD oe 42 aw cm ees 4S ow Oe oD OD ew 4 om 6 oD «= oe 


Indicates MTM system is ready to 
accept a command. 


Indicates a request for input 
datae 


Indicates 2 request that input 
data be copied to a BUILD file. 


Indicates that the system is 
ready to accent a command while 
an interactive task is active. A 
new CSS cannot be initiated at 
this time. A user can instruct 
MTM to suppress or enable the 
appearance of this prompt while 
an interactive task is running; 
but not while CSS is running. 


1-7-2 Terminal Conventions 


The conventions in effect for various terminal 


in Table 1-2. 


mem ae ep ose ep OE sees aoe eee eee em Oe ee eee ae em oe ae 


devices are 


shown 
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TABLE 41-2 TERMINAL CONVENTIONS 


i 
| 
1 
1 
1 
I 
1 oO 
! "od 
i 
| ow 
1 > 
i ae 
je 
1 oO 
=< 
! 
1 
' 
1 
t 
| 
I 
idee 
' 
' 
i 
' 
( 
t 
! 
i 
\ 
! 
| 
j 
i 
{ 
1 
1a 
{ oO 
|= 
i< 
iw 
(= 
{| +3 
1H 
1 O 
} = 
) 
i 
i 
' 
{ 
i 
t 
i 
{ 
1 
\ 
i 
( 
{ 
1 


Delete a line To delete aline simultaneously de- | 
press the CTRL and character x keys | 
for all terminals except TEC 455 VDU | 
which uses the number sign (#4). Basic | 
communications support both # and | 
CTRL x for line deletion for asynchro-| 
nous remote devices. j 
| 
Delete a character To delete a character, depress the | 
Backspace key. For terminals without a | 
Packspace key, Simultaneously deovress | 
the CTRL and character h keys. | 
Fnd an input line To process an input line, depress the | 
Carriage return (CR) key. { 
| 
| 
| 
| 
| 


To communicate with MIM while an 
interactive task is executing or when 
a RUILD command is active, depress the 
Break xey and enter a command. 


Communicate with MIM 


wee wee aus Sse eee ee ee eee Se cee eee wee eee ee ee eee 
wen O-—P au «exe osete ese 8 eee eee Oe ee eases CED ae came <S emEen owes GfOte coe 


ie7e2e-1 Using the Break Key 


If the data request prompt (>) or a BUILD request prompt (B>) is 
displayed and the user wishes to communicate with MTM, depress 
the Break key and the system is ready to accept a command. 


If input or output to the terminal is in progress, the 8reak key 
interrupts the process. For example, if the DISPLAY or EXAMINE 
commana was entered and the output is in progress, depressing the 
Preak key halts the output in progress. The system is then ready 
to accept a command. 


If CSS is currently running, the Break key interrupts the 
eyecution of CSS. The system is then ready to accept a command. 
Once the command has executed, CSS will resume operation unless 
the entered command affects the status of CSS. 
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1-7-3 Command Conventions 


Commands are accepted one line at a time. Multiple commands can 
appear oon the same line, but each must be separated by a 
semicolon. Multiple commands are executed sequentially. Tf an 
error is encountered in a multiple command line that was entered 
from a terminal, the commands following the command in error are 
ignored by MTM. For a command line entered from a CSS, the 
commands on the command line are skipped until a S$TERMJOB is 
found. A character string preceded by an asterisk in column 1 is 
a comment. 


1-7-4 File Conventions 


A file is a collection of data stored on a direct access storage 
device. MTM provides terminal users with the capability of 
Creating and editing files in an interactive manner. Once 
created, files remain on the system until they are deleted by the 
ownere However, during the life of a file, ownership can change, 
based on the needs of an installation or project. File ownership 
is established and maintained by MIM via an account number 
mechanism. 


Ye7e4e-1 Private Account Numbers 


During the signon procedure a terminal user must supply the 
private account number in addition to the correct password. 
Whenever a terminal user allocates a file during an MIM session, 
the MIM system automatically associates the file with the 
terminal user’s account number. A file associated with the 
terminal user‘’‘s account number is referred to as a private file. 


The owner of orivate files has unrestricted access to those files 
and can update, execute, access, or delete as reguired. 
Furthermore, no other terminal user can gain access to another 
user's private files. However, to supply greater flexibility for 
file sharing, MTM supports the concept of group files. 


1-7-4.2 Group Account Numbers 


Authorized MTM terminal users are assigned poth a private account 
number and a group account number within the AUF. Unlike the 
private account number, a terminal user is not required to submit 
the group account number during the signon procedure. In fact, 
a terminal user does not need to know the group account number. 
The group account number will generally be the private account 
number of a different authorized terminal user. By using the 
RENAME command and supplying the letter ‘G' in the account field, 
a terminal user can change a private file to a group file. 
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As an illustration of the use of group files within an 
installation, consider a normal development activity consisting 
of two or more members working under a project leader’s control. 
During the early development phase, each member would probably 
work alone, using private files. dqowever, during the project 
integration phase, the majority of the private files wouli be 
Switched to the project leader’s private account number which was 
defined as the group account for the individual members. 


Once a private file has been switched to a group file, the 
Original private owner no longer possesses unrestricted file 
manipulation capability. Insteced, the file can be read or 
executed by the original owner and any other terminal user with 
the same group number. Updating or deleting the file can now be 
performed by any terminal user who signs on with the group 
account number. 


Rithough the use of group files provides a Somewhat flexible file 
sharing capability, it does not address the problem of universal 
sharing. For this purpose, MIM supports the concept of system 
files. 


1-7-4243 System Account Numbers 


In a way Similer to Switching a private file to a group file, a 
terminal user can supply the letter °S* in the file account field 
instead of the letter ‘'G'. The letter S indicates that this 
Private file is now considered a system file. System files have 
am account numver of Q. They can be read or loaded by any 
authorized MIM terminal usere However, updating or deletiny a 
system file can be performed only by the system operator. 


Within an MTM environment, the system operator is viewei as more 
privileged than terminal users with respect to file ownership. 
The system coverator can allocate system files and can also 
designate an existing file to be made private, group, or sySten. 
Similar to a terminal user, the system operator uses the RENAME 
command to change file ownership. 


1272-424 File Descriptors 


File descriptors are required «ith some commands. A file 
descriptor for MTM generally includes tour fields: 


e LCisk volume name cr device name 
e Filenane 
e File extension 


e File class 
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The format of the file descriptor is: 


- 


L user voln: 


voln: 


Parameters: 


voln: 


filename 


2ext 


@) 


1 P 
filenane [-fex¢] | / : 


is the name of the disk volume on which the 
file resides, or the name of a device. Yoln 
can be from one to four characters. The first 
character must be alvhabetic and the 
remaining, alphanumeric. This parameter need 
not be specified. If this parameter is not 
specified, the dafault volume (set with the 


VOLUME ceommand) is used. When voin is not 
specified, the colon separating voln and 
filename must not be entered. Where voln 


refers to a device name, a colon nust follow 
the device name, and neither the filename nor 
the extension is entered. 


is the name of a4 file. A filename consists of 
from one to eight alphanumeric characters, the 
first cf which must be alphabetic. 


is a 1- to 3-character alphanumeric tring 
preceded by a period specifying the extension 
to a tilename. If the period (.) and 


extension are omitted, a default extensioa 
appropriate to the particular command in which 
the fd appears is appended to the filename. 
Tf the period is specified and the extension 
is omitted, the default is blanks. 


indicates a private file. A private file has 
the same account number as the terminal user 
who created the file. All of the facilities 
for file manipulation are available to the 
cewher cf this file. No other user has access 
to this file unless it is also a yroup file. 
That is, the account number of the user who 
created the file is the same as some other 
user’s group account number. P is the default 
value if neither P, G, nor S is indicated in 
the command. 


indicates a group file. A group file, which 
is a user's private file, is accessible to 
other terminal users for read only. The grouns 
file acccunt number in the AUF indicates to 
the system which users can access this group 
via ae 
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indicates a system file. A system file has 
account number 0. Rh terminal user can only 
read a system file. 


The following are valid examples of file descriptors: 


PACK: FRED.TSK 


FRED.TSS 


ARC:FOO/G 


CARD: 


AsB.C/G 


Ge-CH3 FOG R00 


is a private file FRED.TSK on volume PACK. 

is the same file as in the previous example, 
if PACK is the default user volume (private 
file). 


is a group file with filename FOO with default 
extension, on volume ABC. 


is a device name. 


S© a group file B, with extension C on volume 


3 


CHAPTER 2 
MULTI-TERMINAL MONITOR (MTM) USER COMMANDS 


2-1 INTRODUCTION 


The tollowing steps comprise a basic MIM terminal session: 


SIGNON MAR,118,SWDOC Identify yourself to MTM by signing 
on to the system. “ater your 
userid, account numper, anda valid 
password. 


VO Ss Establish the volume you will be 
working on by entering the VOLUME 
command and a valid volume name. 


LOAD FOXIT3E2 Load the editor task into memory by 
entering LOAD and the task name. 


START Tnitiate  2xecution of the tas 
‘ by enterin; tne START command. 
S FILE Save ali data appended to your file 


by entering the SAVE command. 


END Terprinate execution of the task 5y 
entering END. 


SIGNOY Fnd the terminal session by signing 
Ort. 
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202 


The 
communications 
manager. 


ALLOCATE COMMAND 


ALLOCATE 


Formats 


ALLOCATE fd, 


Parameters: 


tO 


ho 


£4 


CONTI3UOUS 


fsize 


lrecl 


commard creates a direct access file or a 
line control block for a buffered terminal 


keys 
CONTIGUCUS,fsize f | 
4665 


yet bsize isize ] 
LNDEX |, / / 
$26 i t i *¥. 


bees 
sect} 


| lrecl1j 717 bsize keys 
malta SLIT + $)] one 
425 ce ess 


is the File descriptor of the device or file 
to he allocated. 


specifies that the file type to be allocated 
is contiguous. 


is a decinal number indicating file siz2 which 
is required tor contiguous flies. Tt 
specifies the total allocation size in 
256-byte sectors. This size may be any value 
up to the number of contiguous free sectors 
existing on the specified volume at the tine 
the command is entered. 


specifies that the file type to be allocated 
is indexed. 


is a decimal number specifying the logical 
record length of an indexed file or [ITA® 
device. It cannot exceed 65,535 bytes. Its 
default is 126 bytes. It may optionally be 
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followed py a slash (/) whith delimits MIlrecl 
from bsize. 


bsize is a decimal number specifying the number of 
256-byte sectors centained in a physical block 
to be used for buffering. This parameter 
cannot exceed the maximum block size 
established at sysgen time. If bsize is 
omitted, the default value iS one sector. 
When the file type is ITAM, bsize is the 
buffer size in bytes. 


isize is a decimal number specifying the indexed 
block size. If isize is omitted, the default 
value is one sector. Like bsize, isize cannot 
exceed the maximum block size established at 
Sysgen time. 


ITAM specifies that the device to be allocated is 
a communications device. 


keys specifies the write and read protection keys 
for the file. These keys are in the form of 
a hexadecimal halfword, the left byte of which 
Signifies the write key and the right byte, 
the read key. If this parameter is omitted, 
both keys default to 0. 


Functional Details: 


To assign an indexed file, sufficient room must exist in system 
Space for two buffers, each of the stated size. Therefore, if 
bsize or isize is very large, the file might not be assignable in 
some situations. Et sysgen time, a maximum block size parameter 
is established in the system, and bsize cannot exceed this 
constant. 


The ALLOCATE command can be entered in command mode, task loaded 
mode, and task executing mode. 


Examples: 


AL JANE.TSK,CO,64 Allocates, on <the default user 
volume, a contiguous file named 
JANE.TSK whose total length is 464 
Sectors (16kb) with protection keys 
of 0. 


AL 4300:AJMeBLK,IN,132/4% Allocates, on yolume 4300, an 


AL 


AL 


THISFILE,IN,256/4/2 


VOL1: AJM.OBJ,IN,-126 


VOT: AJM.OBJ,IN,126//3 


indexed file named AJM.~BLK with 
logical record length of 132 pytes, 
data block size of four sectors, and 
default isize of one sector. The 
protection keys default to 9. When 
this file is assigned, the system 
must have 2.25kb of available system 
space for buffers. 


Allocates, on the default user 
volume, an indexed file named 
THISFILE (blank extension) with a 
logical record length of 256 bytes, 
a data block size of four sectors, 
an index block size of two sectors, 
and protection keys of 0. 


Allocates, on volume VOL, an 
indexed file named AJM.OBJ whose 
logical record length is 126 bytes. 
The buffer size and indexed block 
Size default to one sector ani the 
protection keys default to 0. 


Allocates, on volume VO1, an indexed 
file named AJM.OBJ with logical 
record length of 126 bytes. fhe 
data block size defaults to one 
sector, the index block size is 
three sectors, and the protection 
keys default to 0. 
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2-3 ASSIGN COMMAND 


The ASSIGN command assigns a device, file, or communications 
device to one of a task'*s logical units. 


Formats: 
access privileges 
SVC15 
SRH keys 
ASSIGN lu,fdl, e\SVCF 
SRO 00056 
VFC 
ERO 
Parameters: 
lu is a decimal number specifying the logical 


unit number to which a device or file is to be 
assigned. 


fd is the file descriptor of the device or file 
to be assigned. 


access are the desired access privileges. The 
privileges default access privileges are: 
- SEad for contiguous and indexed files 


- SRO fer private files within the group ofr 
System acccunt 


- FRC ter devices 


kevs Signifies the read/write protection keys of 
the file or device to be assigned. 


S¥C15 Signifies that the specified device is to be 
SVCF assigned for SVC 15 access. SVCF is the 
hexadecimal equivalent of SVC15 and can also 
be specified. This option pertains to 


communications devices only. If SVC 15 access 
is svecified, vertical forms control cannot be 
specified. 
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in 


oe OU ee ee Or 6 


VFC specifies the use of 


for the assigned 


specified, SVC 15 access cannot be 
is omitted, 


If this parameter 


vertical 


forms control 


lu. If this parameter is 


specified. 
there is no 


vertical forms control for the device assigned 


to the specified lu. 


Full VEC support is in effect only if output 
is to a line printer. 


Pad 


NOTE 
bie 3 the access privileges and keys 
parameters are omitted and VEC is 
specified, the positional commas 
belonging to the omitted parameters can 
be omitted. 
If the access privileges and VFC 


Parameters are specified 


parameter is omitted, the 


and the keys 


positional 


comma btelonginzg to the keys parameter can 


he omitted. 


Functional Details: 


Access privileses can be one ot the following: 


SRO sharable read-only 

FRO exclusive read-only 

SWC sharable write-cnly 

kWO exclusive write-only 

SRW sharable read/write 

SREW Sharabie read, exclusive write 
ERS4@ exclusive read, sharable write 
ERW exclusive read/write 


when the SVC 15 option is specified, 
EFW access privileges are accepted. 


only SRW, 


The DISPLAY LU command is used to determine the 
Privileges of all assigned units. The command is rejected if the 
requested access privilege cannot be granted. 


SREW, ERSdA, and 


current access 
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When a task assigns a file, it might want to prevent other tasks 
from accessing that file while it is being used. For this 
reason, the user can ask for exclusive access privileges, either 
for read or for write, at assignment time. This is called 
dynamic protection because it is only in effect while the file 
remains assigned. 


A file cannot be assigned with a requested access privilege if it 
is incompatible with some other existing assignment to that file. 
A request to open a file for exclusive write-only is compatible 
with an existing assignment for SRO or ERO, but is incompatible 
with any existing assignment for other access privileges. Table 
2-1 dllustrates compatibilities and incompatibilities between 
access privileges. 


TABLE 2-1 ACCESS PRIVILEGE COMPATIBILITY 


tI 
ty 
Y) 
= 
t) 
rd 
O 
op 
Zw 
© 
U2 
ma 
x. 
Y 
= 
O 
ry 
> 
O 
UW) 
pe 0) 
t¥) 
x= 
tr 
8] 
x 


eee 
am 


_e diene “OR we au wee eee ee ee ee ecemm eee eee CR eee 
ane ewe eee =P eee eee wT eee ee KO eee OD ee eee, 


LEGEND 


* compatible 
- incompatible 


The keys format is a 4Yedigit hexadecimal number. The left two 
digits signify the write protection key and the right two digits, 
the read protection key. If omitted, the default is 0000. These 
keys are checked against the appropriate existing keys for the 
file or device. The command is refected if the keys are invalid. 
The keys associated with a file are specified at file allocation 
timee They may be changed by a REPROTECT command or through an 
SVC 7 reprotect function call. 
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If the values of the keys are within the range xX*°01°' to X°*FE', 
the file or device cannot be assigned for read or write access 
unless the requesting task supplies the matching keys. If a key 
has a value of X*00‘, the file or device is unprotected for that 
access mode. Any key supplied is accepted as valid. If a key 
has a value of X*FF*, the file is unconditionally protected for 
that access mode. It cannot be assigned for that access mode to 
any user task, regardless of the key supplied. 


Some examples of protection uSing keys are: 


KEY KEY MEANING 

00 09 Completely unprotected 

SF FF Uncondiitionally protected 

07 oc Unprotected for read, conditionally 
protected for write (user must 


Supply write key=X'Q7' ) 


EF a7 Unconiitionally protected for write, 
conditionally protected for read 


09 im Uncorotected £or write, uncon- 
dition2z2lly protected for read 


Pa 32 Candititonally protected for both 
read sind write 


An assigned direct access file is positioned at the end of the 
file for access privileges SWO ani EWO. It is positioned at the 
beginning of the file for all other access privileges. The 
command is rejected if the specified lu is already assigned. To 
reassign an lu for an active task, the lu must first be closed. 


The ASSIGN command can be entered in task loaded mode. 


Examples: 


AS Z2,FILE.-DAT,EWC,99AA Assigns a disk file to lu 2. The 
EYO access privilege causes the file 
to be positioned at the end. It is 
conditionally protected with write 
and read keys of 99AA.~ New records 
are appended. 
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AS 2,T®ST.JCE,VEC 


AS 2,TEST.JOP,,,V¥FC 


AS 2,TEST.JO5,,VEC 


AS 2,TEST.~JOR,SRO,VFC 


Invalid Examples: 


AS 27 TeatedOss,CCh rs, VEC 


Assigns a disk file to lu Dm 
Vertical forms control is in use. 
Access privileges and keys 


Parameters are omitted along with 
their respective commas. 


Assigns a disk file to lu 2e 
Vertical forms control is in uSe. 
Access privileges and kays 
parameters are omitted but 
positional commas are specified. 


Assigns a disk file to Lu Zs 
Vertical forms control is in uSe. 
The positional comma belonging ¢t9 
tne omitted access privileges 
Parameter must be specified. 


Assigns a disk file to lu % 
Vertical forms control is in effectt. 
The Keys parameter, along with the 
positional comma, is omitted. The 
privilege is shared read only. 


Invalid assignment because the 
positional comma belonging to the 
omitted access privileges parameter 
must be epecified. 


AS Z,TrSTeJOE,SXO,VEFC,SVC1S 
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Invalid assignment because vertical 
forms control and SVC 15 access are 
mutually exclusive and cannot be 
Specified in the same assignment. 


| BFILE t 


ap am a ap 4 4) 4) @ @ & = 


2-4 BFILE COMMAND 


The BFILE command backspaces to the preceding filemark on 
Magnetic tapes, cassettes, and direct access files. 


Format: 


Parameters: 
fa is the file descriptor of the device or file 
to pe backspaced to a filemark. 
lu is the lu to which the file is assigned. If 
lu is specified without fd, the operation is 


performed on the lu regardless of what is 
assigned to ite 


Functional Details: 


The BFILE command can be entered in task loaded mode. 


Examples; 
BF 17 Causes the device or file assigned 
to lu 1 to bacxspace one filemark. 
BE M300:AJM.O8J,4 Causes file AJM.ORJ, that is 


assigned to lu 4 on volume M300:, to 
backspace one filemark. 
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2-5 BIAS COMMAND 


The BIAS command setS a base address for the EXAMINE aad MODIFY 
commands. 


Format: 


address 
BIAS 


* 


Parameters: 


address is a hexadecimal bias to be added to the 
address given in any subsequent EXAMINE or 
MODIFY command. For a u-task, the address 
must be a valid address that exists for the 
u~taske For an em~task, the address can be any 
valid address in the system. The addresses 
rust be aligned ona halfword boundary. If 
address is omitted, it is assumed +9 be the 
reginning of the task. 


* sets pies to 0 for a u-task and to the 
Ehysical load address for an e-task. 
Functional Details: 
A FIAS command overrid2s all previous BIAS commands. The user 
should enter a BIAS command if the current value is unknown. 
The BIAS command can be entered in task loaded mode and task 
executing mode. 


Examples: 


BI 160 Sets bias to 109 


KW8-043 FOO ROO Po Oe 


on eee OO cee eee Se eee 


2-6 BREAK COMMAND 


The BREAK command returns a break status (X°8200') to a task with 


an outstanding I/0 on the 


Format: 


BREAK 


Functional Details: 


MTM terminal. 


The BREAK command can be entered in task executing mode. 
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2-7 BRECORD COMMAND 


The BRECOPD command backspaces to the preceding record on 
magnetic tapes, cassettes, and direct access files. 


Formats: 


BRECORD [£4,] lu 


Parameters: 
pas! is the file descriptor of the device or file 
to be backspaced one record. 
lu is the lu to which the file is assigned. re 
lu is specified without fd, the operation is 


performed on the lu regariless of what is 
assigned to ite 


Functional Details: 


The BRECORD command can be entered in task loaded mode. 


Exampless 
RR 1 Causes the device or file assigned 
to lu 1 to backspace one record. 
BR M300:AJM-QBJ,4 Causes the file AJM.O2J, assigned to 


lu 4 on volume M300, to backsvace 
one record. 
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2-8 BUILD AND ENDB COMMANDS 


The BUILD and ENBB commands copy data from the command input 
device to the fd specified in the BUILD command. 


Format: 


fd 
purie | [APPEND] 
lu 


ENDB 
Parameters: 


fa is the file descrirtor of the device or file 
to which data is copied. If fd does not 
ccentain an extension, .CSS is usad as a 
default. If a blank extension is desired, the 
pericd following the filename must be tyned. 
If fd refers to a direct access file, an 
indexed file by that name is allocated with a 
logical record length equal to the command 
buffer length established at sysgen time, a 
blocksize or 1, and keys of QO090. If the 
specified fd already exists, that fd is 
deleted and a new fd is allocated. 


Lu is the lu to which the file is assigned. b 
temporary file is allocated and the BUILD data 
is covied to ite When the ENDS is 


encountered, the temporary file is assigned to 
the specified lu of the loaded task. This 
form of the BUILD command is only valid when 
a task is loaded. 


APPEND allows the user to append data to an existing 


Qs it the fd does not exist, it is 
allocated. 
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Functional Details: 


Lines entered from the terminal after the BUILD command are 
treated as data, and are copied to the specified device or file 
until an ENDB command is encountered. cNDB may be followed by 
until an ENDE command is encountered. ENDB may be followed by 
other cemmands in the ccmmand line. Data following the ENDB 
command is treated as a command. If any data follows the BUILD 
command on the same line, it is treated as a comment and no 
action is taken. The BUILD command can be entered from the 
terminal only if CSS is not active. It can be entered in 
command, tesk loaded, and task executing modes. 


Example: 


EUILD aASSN 

AS 1, CRs: 

AS 2, OUT.OBJ 
AS 3¢ PR: 

AS 5, CON: 
END® 
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2-9 CANCEL COMMAND 
Be CANCEL command terminates a task with an end of task code of 
Format: 
CANCEL 
Functional Details: 
The normal response to this command is: 


Signon name FND CF TASK CODE=255 CPUTIME=utime/ostime 


The CANCEL command can be entered in task loaded mode and task 
executing mode. 


NO 
t 
— 
tT 
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2-10 CLOSE COMMAND 


The CLOSE command closes (unassigns) one or more files or devices 
assigned to the currently selected task's logical units. 


Formats: 
lu, [-luz,ee.luy] 
CLOSE 
ALL 
Parameters: 
lu decimal numbers signifying the logical units 
to be closed. 
ALL specifies that all logical units of the task 


are to be closed. 
Functional Details: 


Closing an unassigned lu does not produce an error message. A 
CLOSE command can only be entered if the task is dormant or 
paused. 


The CLOSE command can be entered in task loaded mode. 


Examples: 
CL Ve365 Closese logical units 1, 3, and 5 of 
the task. 
CLOCE A Closes all logical units of the 
task. 
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| CONTINUE 4 


2011 CONTINUE COMMAND 


The CONTINUE command causes a paused task to resume operation. 
Format: 

CONTINUE [address] 
Parameter: 


address is a hexadecimal nunber that specifies where 
the task is to resume operation. If this 
parameter is not specified or is 0, the task 
resumes at the instruction following the 
pause. 


Functional Details: 


The CONTINJE command can be entered in task loaded mode. 
Executing this command causes the terminal mode to he switched 
fror task loaded mode to task executing node. 
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2-12 DELETE COMMAND 


The DELETE command deletes a direct access file. 
Formats: 


DELETE fd, [,-fda,0+-,fdn] 


Parameter: 


fd identifies the file(s) t% be deleted. 


Functional Details: 


The file being deleted must not be currently assigned to an lu of 
any task. & file can be deleted only if its write and read 
protection keys are 0 (X*0000°). If the keys are nonzero, they 
can be changed using the REPROTECT command. Only private files 
can be deleted. 


The DELETE command can be entered in command mode, task loaded 
mode, and task executing mode. 
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2-13 DISPLAY ACCOUNTING COMMAND 
The DISPLAY ACCOUNTING command displays accounting data collected 


for a currently running or previously run task. 


Format: 


fd 
DISPLAY ACCOUNTING |, 
user console 


Parameter: 


fd is the file descriptor to which the accounting 
information is displayed. The user console is 
the default. 


Functional Details: 
The DISPLAY ACCOUNTING command displays this information: 


USER TIME hhs:mmsesenms 
SVC TIMF hbhsmmsss.ms 
WAIT TIME HFAsmm:sse.ms 
POLL TIME hh:mmessems 
I/O an 

ROLLS “A 


The CISPLAY ACCOUNTING command can be entered in command  =*node, 
(providing at least one task has been run during the current 
terminal session), task ioaded mode, and task executing node. 
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2-14 DISPLAY DEVICES COMMAND 


The DISPLAY DEVICES command displays to the specified fd the 
physical address, keys, online/offline state, and the volume name 
(for online direct access devices) of all devices in the systen. 


Format: 


fd 
DISPLAY DEVICES ; 
user console 


Parameter: 


fd is the file descrirtor specifying the file or 
device to which the display is routed. If fd 
is omitted, the default is the user console. 


Functional Details: 


The DISPLAY DEVICES command can be entered in command mode, task 
loaded node, and task executing mode. 


48-043 FOO ROO 2-21 


Example: 


DSCi C6 0000 MUD1 PROT CDIR 
CDSC2 C7 0900 FIXD RES CDIR 
DSC3 C6 0900 MT M Sf 

CSCu D7 Q000 FIXKY 

DSC5 £6 0000 OFF 

CT6E7A FC 0900 V67A COIR 


In the DISFLAY DEVICES output, columns 1, 2, and 3 contain the 
device name, device number (address), and keys, respectively. 
Column 4 is only defined for pseudo-print (spool), ITAM 
(communications), and direct access devices. The characters SPOL 
specify that the devices are rseudo-eprint devices used in 
spocling. 


For direct access devices, colutrn 4Y contains the characters OF 
to indicete that the device is orfline. [If online, the volun 
name is sutput in column 4. For write-protected disks, column 
contains the characters FROT. For MIM users, if the disk is 
write-orotected, column 5 ccentains the characters SYs. If the 
disk is restricted, column © contains the characters RES. I[£f the 
seccndary directory option is enabled, the last column contains 
the characters CDIF. 


cr 
e 
2 
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2-15 DISPLAY DFLOAT COMMAND 


The DISPLAY DFLOAT command displays to the specifiei fd the 


contents of the double precision floating point registers 
associated with the loaded task. 
Format: 
fd 
DISPLAY DFLOAT jf, 
user console 

Parameters: 

fd is the file descriptor specifying the file or 

device to which the contents of the double 


precision floating point registers associated 


with a user-specified task are displayed. If 
fd is omitted, the default is the user 
console. 

Functional Details: 

The user-specified task should have been built with the DFLOAT 


Option at Link time. 


The DISPLAY DFLOAT command can be entered in task loaded and task 
executing node. 


Example: 
D DFL 
0,2 00000000 00000000 00000000 00000000 
4,6 00000000 00000000 90000000 00000000 
&6,A 00000000 000090000 60000000 00000000 
Ce~E 00000006 000600000 00000009 00000000 
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| DISPLAY 
FILES 


2-16 


DISPLAY 


FILES COMMAND 


The DISPLAY FILES command permits information from the directory 


of 
fds 


one 


Format: 


DISPLAY EILES 


or 


more direct access files to be output to a specified 


; voln: 


[filename] [- [ex €] | 


default user val 


fd 
/ S ’ 
YSer console 


G 


NOTE 


Please see Functional Details for variations on the DISPLAY 
FILES command syntax. 


Parameters: 


2-24 


yolin 


ext 


*e 
® 


specifies that all files with the user account 
number pe displayed regardless of what volume 
they reside on. Entering the colon with part 
of a filename limits the file search to 
filenames with the specified characters. 


is a i- to Yecharacter name of a disk volume. 
The first character must be alphabetic, the 
remaining alphanumericer If voln is onittel, 
the default is the user volume. 


is a I- to &8-character name of a file. the 
first character must be alphabetic, the 
remaining, alphanumeric. 


is a 1- to 3-character extension to «the 
filename. 
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Pp indicates that information is requested for a 
private file. 


S) indicates that information 1s requested on a 
system file; default is private files only. 


G indicates that information is requested for a 
group file: default is private files only. 


fd is the file descriptor specifying the file or 
the device to which the display is output. If 
fd is omitted, the default is the user 
console. 


Functional Details: 


A hyphen (-) in the command format requests that all files 
Starting with the characters preceding the - or following the - 
are displayed, subject to any restrictions specified in the 
extension, account number, and fd fieldse. For example: 


CAL32- disolays all files whose first five characters 
are CAL322. 


CAL32.-— 4isplays all files named CAL32 with any 
extension. 

-~ .MTM fisplays all files with the the extension Mi. 

CH-.043 displays all files beginning with CH, with an 


extension of O43. 


The character * recnests that all files with matching characters 
in the same position(s) as those entered are displayed. For 
example: 


CAL32*** dieplays all files between five and eight 
characters in length whose first five 
characters are CAL32. 


CAL**CAL displays all files, with a filename eight 
characters long, whose first three and last 
three characters are CAL. 


«eee 32.08 displays all files with a filename containing 


cix characters whose fifth and sixth 
characters are 32 and whose extension is .OFfJ. 
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The characters * and 


desc 
exam 


A colon entered with part of a 


file 


wearer .on- 


names with 


displays all 
whose 


ribed previously, to 

ple: 

CAL**1- displays 
characters 
is 1. 


last 


all 


are CAL, 


files, 
two 


files 


eight 
characters 


whose 


extension begins with an 0. 


the 


specified characters, 


DF, :J4- 


user 


filename and a dash 


account 


A colon entered with a specified 


unde 


r the user 


account 


number 


extension 


with 


regardless of what volume they reside on: 


Di Fated ¥ 


An example of the disolay produced 


is: 


D F,FIADs-.TSK/S 


VOLUME= FIXD 
FILENAME EXT TYFE 
DSKSPACE TSK CO 
OSCOPY TSX IN 
Jrc TSK CO 
COROL TSK Co 
D F,TAS-/- 

VOLUME= V678 
FILENAME E&XT TYPE 
TAS CSS IN 
TASKRT TSK CO 
D F,7e7/S 

VOLUME= V678 
FILENAME EXT TYPE 
INA1 IN 
INA2 css IN 


LEN3TH 
9 

256 

31 

26 


LENGTH 
80 
105 


LENGTH 
126 
109 


KEYS 
¥*N0 
#709 
**90 
**00 


KEYS 
**H0 
0900 


R215 
**00 
**OO 


by the DISPLAY 


START/NLR 


START/NLR 
4 
218 A* 


START/NLR 
0 
1 


number 


starting 
regardless of what volume they reside on: 


displays 
the specified extension, 


- can be combined in the command format, 
further delimit files displayed. 


first 
and whose sixth character 


characters 
are 32 and whose 


displays 
with 


all 


as 
ror 


three 


long, 


all 
the 


files 


FILES command 
CREATED WRITTEN ACT 
6/03/79 6/09/79 @) 
6/99/79 6/39/79 4 
U/O7/79 W/O7/7?2 s) 
7/27/78 0/00/00 e) 
CREATED WRITTEN ACT 
6/09/79 6/09/79 13 
Y/O7/79 &4/DTST9 22 
CREATED WRITTEN ACT 
6/09/79 6/09/79 0 
6/09/79 6/09/79 oO 
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For contiguous files, TYPE is CO, LENGTH is the number of Sectors 
allocated to the file in decimal, and START/NLR is the starting 
sector number in hexadecimal, followed by *,. 


For indexed files, TYPEF is IN, length is the logical record 
lensth in decimal, and the START/NLR is the number of logical 
reccrds in decimal. 


ACT is the associated user's account number. It is the user's 
acccunt number for private files, the group account number for 
group files and 0 for system files. 


The DISPLAY FILES command can be entered in command mode, task 
loaded mode, and task executing mode. 


Exampless 


DF displays to the user terminal all 
files with the user’s account number 
on the default user volume. 


CD E,CAL32.TSK/- displays file CAL32.TSK in the 
private, group, and system accounts. 


CD F,-/- displays all files in the private 
group and system accounts on the 
default user volume. 


D F,e¢MAG13 displays, to the device MAG1, all 
| files with the user*’s account number 
on the default user volume. 


D F,M300:3 displays, to the. user's terminal, 
all files with the user’s account 
number on volune M300. 


CD F,M300:A-.TSK displays all files on volume M300 
with first character A and extension 
TSK in the user’s account number. 


D Fytme, PRI: displays all files on the default 
user volume in the user's account 
Number with blank extension, 
regardless of filename. The display 
is routed to device PR1:. 


DC EF,CAL**1-.- displays, to the user's terminal, 
all files that start with CAL, 
contain the character 1 in the sixth 
position, have any extension and are 
in the user‘s account number. 
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D fF gims TASK<5* 


D 


F,-sTASK.- 


displays to the user's terminal the 
files named TASK that have one or 
two character extensions starting 
with the character ©. A separate 
display of these files is done for 
each online disk volume whose name 
starts with the letter M. 


displays to the user's terminal the 
files named TASK, with any 
extension. A separate disvlay of 
these files is done for each online 
disk volume in the system. 
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{| FLOAT | 


2-17 DISPLAY FLOAT COMMAND 
The DISPLAY FLOAT command displays to the specifiei fd the 


contents of the single precision floating point registers 
asscciated with a the loaded task. 


Format: 


fd 
DISPLAY FLOAT |, 
usér console 


Parameter: 


rd is an optional file descriptor specifying the 
tile or device to which the display is output. 
If td is omitted, the display is output to the 
user’s terminal. 


Functional Details: 
The user-specified task must be built with the FLOaT option 
specified at Link time. 


The DISPLAY FLOAT command can be entered in task loeadei mode. 


Examples 


De , 

O,2 90000000 00000000 
4,6 00000000 00000000 
B,A 00090000 00090006 
C,E 60000000 00900000 
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th) 
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2-18 DISPLAY LU COMMAND 


The DISPLAY LU command displays to the specified fi all assigned 
logical units of the loaded task. 


Forrnat: 
fd 
PISPLAY JU ’ 
user console 
Parameter: 
fd is an optional file descriptor specifying the 


file or device to which the assigned logical 
units are to be disovlayed. If fd is onitted, 
the default is the user console. 


Functional Details: 


The lu number, file or device name, current access privileges, 
current record number, and vercentage thru file are displayed. 
The current record number and vnercentage thru file are disvodlayed 
only for files. 


PLUSZUEV ICE | RECORD THRU 
MATASSADPROC.CSS/000,Sh0 30 15.0% 
CON:,SRW 

CON:,S&8W 

CON:,SEFW 


DON w ~—-— & 


MO7AS:RADPROC.CSS/900,SR0 200 100.0% 
CON:,SRW 
M67A3£2614586.001/000,SREW 1 100.0% 
CON:,SRW 
CON:,SRW 


Ain & w 


ho 
' 

tad 

O 
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The DISPLAY LU command can be entered in task loaded mode and 
task executing mode. 


Example: 


DISP LU,FR: Displays assigned logical units to 
the printer device (PK:). 
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| DISPLAY | 
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22-19 DISPLAY PARAMETERS COMMAND 
The DISPLAY FARAMETERS command displays the parameters of the 
loaded task. 


Formats: 


fd 
PISPLAY PARAMETERS |, 
user console 


Parameter: 


fd is an ootional file descriptor specifying the 
file or device to which the display is output. 
Tf Fi is omitted, the default is the user 
console. 


Functional Details: 


Table 2-2 lists the field addresses ani data displayed when the 
DISPLAY PARAMETERS command is entered. 


TABLE 2-2 DISPLAY PARAMETERS COMMAND FIELDS 


| FIELD {| VALUE { MEANING | 
| =SS SS SS SS SF SS SS OS Se SS SS Se Se Se en oe a ae ae aD SD Se ae ae SS SD a aS SS ae a cas an Sup aoe oo sae Se com sor aoe { 
{| TASK | xxxxxxxx | Task name, also user signon 
| | name | 
| | | | 
i <Glon | xxxxxxxx | Status portion of current [SW | 
| | | 
{ CLOC | XxXxxx | Current location 
| | | | 
{| STAT | xxxxx {| Task wait status 
| | | | 
| TOPT | xxxxx | Task options { 
| | 
|} YSSP | XXXxXX | Current used system space | 
| | | | 
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TABLE 2-2 DISPLAY PARAMETERS COMMAND FIELDS 


(Continued) 
| FIELD | VALUE | | MEANING ! 
a { Miers a a cn 
: MXSP : XxX XXX | Maximum allowed system space | 
| CTOPr | xx xxx , Task CTOF : 
: UTOP : XX XXX : Task UTCFE : 
| U8OT | XXXXX . Task UBOT . 
! SECE : XXX | Task starting location : 
: NLU ! XX | Number of logical units : 
| | | (decimal) 
| 
{ MPRI | xxx | Maximum priority (decimal) { 
| SV¥VCL : XXXX . Lefault volume ID : 


The addresses displayed as CTOP, UTOP, UBOT, and SLOC are not 
ohysical addresses, but addresses within the task*‘s own program 
spacee CLOC may be a program space address or a physical address 
in 2 system subroutine being executed cn behalf of the task. NLU 
is given in decimal. SVCL is the ASCII system volume ID. The 
fields CTOP, UTOP, UPOT, and SLOC are described in detail in the 
OfS/32 Application Level Programmer Reference Manual. 


TCPT is given in hexadecimal. The definitions of task option 
bits are listed in Table Z-3. 


TABLE 2-3 TASK OPTION BIT DEFINITIONS 


0 = I/C interpreted without VFC 
= All I/0 interpreted with VFC 


{ RIT | MASK | MeANING | 
{ FSS SS SSS SSS SSS SS BFS OFS SSS SF SS Oe ae ee a a ae DD SD a AD SND SD SD SD ED SD GD SD EOD SU SD GOD Se aD mS GD MD ee anew | 
f 4 | 6800 COCO | O = Dynamic scheduling disabled 
{ | | 1 = Dynanic scheduling enabled | 
| | | | 
i 5 | 0400 9000 { 29 = Prompt disabled | 
| | { 1 = Prompt enabled | 
| | | 
{ 6 | 0200 0090 } 
| | | 
| | | | 
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TABLE 2-3 


TASK OPTION BIT 


DEFINITIONS (Continued) 


=~ Gut cp cm OD 8 ae GD OD awe owe OO ap « OD a 28 eS ar Gm oF «a2 OF FE CD Cn ow a 22 om 22 ew 28 er ee et OD om Oe OR <8 oe OO Po ee ee oe 88 ee ee ae aw aw ae 
oan an am ap as am cp +o = Ge GP =e ote OP OD oF a8 @e 6 a @ 2D 8 «cw 4 a a OP ew ae a4 ae ee ane GD er cm C8) 8 ee Ge GD 8 en 22 =D OD cee ee ae @e 2 2 ee @e am oe 


one ona weet <eem eumed Gee einen Gm 
ee a le (ie OO mentee Gece OU gene “EN ORO wat I AR NE GO GUC etiR “MOR GREE UTED OUTS GENRE GeninetD GRRE “ERS eeretD <OUET NN 6 cemenS SE EEN VINEE <meuens nome CamUNER nite. ene 
RIED ae aa 


10 


16 


17 


ae 


19 


20 


21 


22 


22 


h) 
in 


27 


ents mame <emtees atmnee cummin candies mth aeeeme aummets “WON emma, “OOO SOM mmee I meen OOOtY ne cena ene ED REO oes SM RD ceEty SED NY aE NERS NE PES SN et ED ON SN CMD AREER mR SRS <P “SD NS NEN metne anemmes “Awl 
ean 


9100 


0080 


0040 


0020 


0000 


0000 


0000 


0000 


0009 


00090 


0000 


0009 


0000 


0000 


O0C00 


8009 


uN00 


2C0C 


1009 


9800 


0400 


0200 


CO19 


ou 


ol 


No extended SVC 1 parameter blocks 
used (excludes communications I/0) 
Extended SVC 1 parameter blocks 


used 


New 


No new TSW 


Task 
Task 


Task 
Task 


event 
event 


event 
event 


U-task 
Em~task 


AFPAINSE 
AFCONT 


NOFLOAT 
Single floating point 


NONRESIDENT 


RESIDENT 


all registers 


partial registers saved 


no register sa 
register saved 


SVC 6 coatrol call 
Prevent SVC 6 control call 


SVC 5 communication call 


Srevent sVC 6 communication call 


SVCPAUSE 
SVCCONT 


NCELCAT 
DELOAT 


NCROLL 


ROLL 


No overlay 


Yse overlay 


Accounting disabled 
Recounting enabled 


TSW for task event service 
for task event service 


savel 


ved 


Task can issue intercept call 


Task cannot issue intercept call 


weanep Gare cme -enee eee eee seen eee aoe oe 


STAT 
bits 


i. 


TAB 


S 


LE 2-3 


0600 O00C8 


0000 C004 


0000 000? 


0900 9001 


given in 


hexad2cimal.e 


TASK OPTION BIT DEFINITIONS (Continued) 


No account privileges 
File account privileges 


Rare disk assign not allowed 
Bare disk assign allowed 


Not universal 
Universal 


No keychecks 
Do keychecks 


ace shown in Table 2-4. 


nh a ane CE autem em OE «sep cee COU eee ae eee weep Se eee em ae em RD «awe eee aaa or 


TABLE 
3IT | MA 
15 | 0001 
16 | 0000 
47 : 5900 
18 : 0000 
19 | 0000 
20 | 90C0 
21 | 0000 
22 | 0060 
23 , 0000 
24 | 0000 
25 : 0000 
26 ! 0060 
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2-4 


0000 
80090 
L609 
2009 
1009 
0800 
0400 
6200 
0100 
00890 
0040 


0026 


WAIT STATUS BIT DEFINITIONS 


one a ee eee Oe ee ee Com coe 8 ewe eee cewe ESP eeu CEE <EO™ ceew ten eR eee eee eee OD 


Intercept wait 
I/O wait 

CAny) IO#/WAIT 
Censole wait (paused) 
Load wait 
Dermant 

Trap wait 

Time of day wait 
Suspended 
Interval wait 
Terminal wait 


Koll pending wait 


oman me OO ne a oe ee eee ee ee we Oe eee ee ee «ase Ge ene 


mm «ape ese SS eeu Eee oe em oe ee ooo 


The definitions of wait status 


{5} 


TABLE 2-4 WAIT STATUS BIT DEFINITIONS (Continued) 


am ama ab GP Gb aD yr rer ewwee <=> Gp a © GP as aD 2D OD of 4® 4D 2D @ GD GD GS 4D OP GP GP OF & CF GOD OP OO G® &2 Gt OP GD OD © @® GD ap 


{| SIT | MASK MEANING | 
| 27 | 0000 0010 | Intercept initialization (NTH) | 
: 28 | 9009 0C08 | Intercept termination (MTM) : 
. 29 7 0000 0004 | System resource connection wait : 
| 30 7 0000 0002 ! Accounting wait : 


NOTE 


Zero status indicates an active task. 


CTswW is expressed 
rortion of the 
Feference Manuale 


hexadecimally. 
TSi, 


ror a definition of the status 
see the OS/32 Anplication Level Programnner 


The DISPLAY EAEFAFRETE RSS command can be entered in task loaded mode 
anc task executing mode. 


Example: 


The 


following is an example of the output generated 


to a DISPLAY FPAPAMETERS command: 


DLS PLAY 


TASK 
CTS¥ 
PS W 

CLOG 
STAT 
TOPT 
USS? 
DUE 
MXSP 
CTCP 
UTOP 
UPOT 
SLCC 
NLU 

PPR 
SVOL 


PARAMETFRS 


MTMUSER 
0000T09C 
UT7TEO 
F2B/7C 
2000 
10021 
14UF2 
2208 
390C 
24UFE 
224k 

0 

FOCSG 

5 bs 

128 
MOTk 


in response 
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2-20 DISPLAY REGISTERS COMMAND 


The DISPLAY REGISTERS command displays to the specified fa the 


contents of the general purpose user registers associated with a 
loaded task. 


Formats 


fd 
DISPLAY REGISTERS |, 
user ccnsole 


Parameters 


fd 3s the file descriftor to which 
of the general purpose user 
Gisplayed. If fd is omitted, the 
cutput to the user console. 


the contents 
registers are 
display is 


Functional Details: 


The DISPLAY REGISTERS command can be entered in task loaded 
and task executing mode. 


mode 


NOTE 


The contents of each register will be 0 
until the task has started. 


Example: 
DR 
PSW OO00077FO OOODE588 
O-3 00000000 €00900000 90000000 00004801 
4-7 OOO00EB3C 000900000 90000000 OOOOD2EA 
®@-B QOOOESBCEB 60000000 COODES 48 90009028 
C-F ODOD0D0E804 OODIEODO OOOO0E584 OGOOEO5SE 
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TIME | 


2e21 DISPLAY TIME COMMAND 


The DISPLAY TIME command displays the current date and time to a 
specified fd. 


Format: 
fd 
DISPLAY TIME |, 
user console 
Parameter: 
td specifies the file or device to which the 


display is to be output. If fd is omitted, 
the default is the user console. 


Functional Details: 

The display has the following format: 
mma/aid/yy hhemm:ss 

or alternatively (ry sysgen option): 
dd/am/yy hhemrsss 


he CLISPLAY TIME commani can be entered in command ~*mode, task 
eded mode, and task executing mode. 
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2-22 DISPLAY USERS COMMAND 


The DISPLAY USERS command displays the userid and terminal device 
names of all users currently signed on. 


Formats: 
fd 
DISPLAY YSERS |, 
user cansole 
Parameters: 
fd specifies the file or device to which the 


display is output. If Fd 1s omitted, the 
fefault is the user console. 


This command can be entered in command mode, task loaded mode, 
and task executing mode. 


Examples 


Ee CROs STARTERI@CTO2: AVE-CTO3: JRd-CTOG: 


b8-O43 FOO 806 2-39 
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i ENABLE | 
2-23 ENABLE COMMAND 
The ENABLE command allows the prompt or messages oreviously 


Suppressed by the PREVENT command to be displayed on the user 
console. 


Format: 


MESSAGE 

PROMPT 
ENABLE 

EIM 


SVARIABLE 


Parameters: 


MESSAGE allows other MTM users to send messages to the 
user terminal. 


PROMPT requests the system to print the hyphen (-) 
promot in task executing mode. 

ET 4 displays the end of task message. 

SVARIABLE enables variable processing on a per user 
basis. 


Functional Details: 


The FNABLE command does not affect operator messages. 


Variable support is included in the target system via the sysgen 
option SGN.VAR. 
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2e28 EXAMINE COMMAND 


The EXAMINF command examines the contents of a memory location in 
the loaded task. 


Format: 
on 
fd 
EXAMINE address,|</address> ’ 
user console 
et 
Parameters: 
adaress indicates the starting and ending adiresses in 
memory whose contents are to be displayed in 
hexadecimal. All addresses specifiei are 
rounded down to halfword boundaries by the 
syeteme 
n is a decimal number specifying the number of 


halfwords to be displayed. If n is omitted, 
one halfword is displayed. 


fd is the file descriptor specifying the file or 
device to which the contents of memory are 
displayed. if omitted, the default is <‘*he 
user ccnsola. 
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Functional Details: 


Specifying only address1 causes the contents or memory at that 
locaticn (as modified Ey any previous BIAS command) to be 
displayed. Specifying address1 and address2 causes all data from 
the first to the second adiress to be displayed. 


The EXAMINE command can be entered in task loaded mode and task 
executing mode. 


Any memory that can be accessed by the loaded task can be 
examined with the EXAMINE command. For example, if a task uses 
a FURKE seament that is mapped to segment register F, then 
examining addresses at FQOQ0C or Greater will display the contents 
of the PURE segment. 


Example: 
BI B100 Examines 10 halfwords starting at 
EXA 190,10 relative address 100 (absolute 


address B100) within the task. 
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2-25 FFILE COMMAND 


The FFILE cammand forward spaces to the next filemark on magnetic 
tapes, cassettes, and direct access files. 
Format: 

FFILE [fd,] lu 


Parameters: 


fd is the file descriptor of the device or file, 
to be forwari spaced one filemark. 


lu is the lu to which the file is assigned. Lt 
lu is specified without fi, the operation is 


performed on the lu regardless of what 1s 
assigned to it. 


Functional Details: 


The FFILE command can be enterei in task loaded mode. 


Examples: 

FF 4 Causes the file or device assigned 
to Lu 1 to forward space one 
filemark. 

FF M300:AJ™.083,4 Causes the file AJM.OBJ on volume 


M300 that is assigned to lu 4, to 
forward space one filemark. 


&8=-C43 FOC FOO 2-43 
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2-26 FRECORD COMMAND 


The FRECC®D command 


forward spaces one record on magnetic tapes, 


Cassettes, and direct access files. 


Formats: 


ERECORD [f4,] lv 


Parameters: 


lu 


Functional Details: 


is the file descriftor of the device or file 
to be forward spaced one record. 


is the lu to which the device or file is 
assigned. If lu is specified without f4, the 
operaticn is performed on the lu regardless of 
what is assigned to it. 


The FEECCR. command can be entered in task loaded node. 


Examples: 
FR 1 Causes the device or file assigned 
to lu 1 to forward space one record. 
Fr 4300:AJ%.OBJ,4 Causes file M300:AJM-~OBJ on volume 
M3990 that is assigned to lu 4 to 
forwata space one record. 
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i HELP | 


° HELP C maugt BE /W spr) 
Ze2l i ommand (/"45< ioe. cam ere 


The HELP command displays information on MTM use ani program 
development commands. 


Format: 


mnemonic t é Vv Evry 
HELP _> mus p L 


® 


Parameters: 
mnemonic is any valid MTM or program developmant 
command mnemonic. 
= causes a list of all MTM and progras 


Aev2elorment commands to be displayed to the 
list device. 


Functional Details: 


The FELP command is implementei as a CSS procedure. when a 
mnemonic or command is entered, information on how t¢3 use that 
Particular commar?’ is displaved to the list device. i a 


parameters are omitted, information on how to use the HEL? 
command is displayed to the list device. 


Examples: 


HELP LOS Displays to the list device 
infortation on how to use the MIM 
LUG commande 


HELP COMPILE Displays to the list device 
information on how to use the 
program development command, 
COMPILE. 

HELP Displays to the list device 
information on how to use the HELP 
commande 
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Example: 


HELE 

ADD 

BIC AS) 
CACNCEL) 
COMFLINK 
EDIT 
EXACMINE) 
FORTO 

Biot 
MECSSAGE) 
PRICNT) 

REF CROTECT ) 
RW 

SCT GNON) 
V(CLUME) 
SUE (MIT) 
FOR KELP ON 
PoE GNC 


© Her LP OAS 


ASSIGN: bios o 


ASSIGN 


AL( LOCATE) 
BRCECORD) 
CL(OSE) 
COCNTINUE) 
ENACBLE) 
EXFC 
FRCECORD) 
LCOAD) 
MODCIFY) 
PUNCCH) 
REWCIND) 
RYOL(UME) 
STCART) 
WECILeE) 
INQCULRE) 
Cer Tat 


COMMAND 


AS( SIGN) 
BUCILD) 
CCBOL 
DEC LETE) 
ENDB 
FECILE) 
HELP 


TCASK) 
XALCLOCATE) 
PUR(GE) 


BFCILE) 
CAL 
COMPILE 
DCISPLAY) 
ENV 

FORT 

LINK 
MACRO 
PREC VENT) 
RENCAME) 
RUN 
SISNOFCF) 
TECMPFILE) 
XDEC(LETE) 


COMMAND MNEMONICS, TYPE HELP 


ASSIGNS A 


DEVICE, PILE OR 


CCMMUNICATIONS DEVICE TO CNE OF A TASK*S LOGICAL UNITS. 


(AS) SIGN LY, 


tO 


“45 


FD¢, @ ACCESS PRIVILEGES, 


KEYS, 


S¥C15 
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2-28 INIT COMMAND 


The INIT (file initialization) command initializes all data on 


ccontiguous file to 


Format: 


segsize incremen 
INIT £dl, 


Parameters: 


fd 


segsize 
increment 


Functional Details: 


a 


‘ete 


O-« 


i 


4. 


is the file descriptor of any unassigned, 
unprotected, contiguous file. 
is the size of the buffer space used. The 


default is 1kb. 


INIT is implemented with a CSS procedure that loads and starts 
the File Manager Support Utility as a task. 


The INIT command can be entered in command mode. 


Examples: 


INIT DATA.FIL 


INIT DATA2.EFIL, 


Nake 
ae 
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Initializes the file DATA.FIL. 


Initializes the file 
a 50kb buffer. 


50 DATAZeFIL using 


| LOAD | 


2-29 LOAD COMMAND 


The LOAD command is used to load a user's task into memory. 
Format; 

LOAD [taskid,] fd [, segsize increnent] 
Parameters: 

taskid specifies the name of the task to be loaded. 


fd specifies the file or device the task is being 
loaded from. 


secsize specifies amount of memory in kb (above the 
increment memory sizes) that the task needs for 
processing. When a task is built (via Link), 


the OPTION WORK=n command adds additional 
memory to atask.e.e The size field in the LOAD 
command overrides the amount of memory 
specified by Link. The size is accepted in 
e25kb increments. 


Functional Details: 


In order to maintain CSS compatibility, a background (.-BG) task 
also can be loaded into menory. Any valid taskid can be entered 
but will be iqnored. 


If a task is loaded from a direct access device, the system first 
searches the user volume oar the specified volune under the user's 
account. If the file is not found in the search, the system 
automatically looks for the file on the system volume in the 
system account. If conly the fd is specified in the LOAD command, 
the extension .TSK is assuned.e The LOAD command can be entered 
in command mode. 


An error might occur if auser ID under MIM is the same as the ID 
of a task loaded from the system console. If a load or fd error 
is displayed, Sign off and sign on again with a different user 
TDs 
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NOTE 


The LCAD command loads the task file <fd> 


into 


the 


terminal user's segnent. The 


TASK and the OPTION commands are ignored 
if the task is currently loaded. 


Examples: 


L VOL: CAL 


Lb. PERP 
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Load the task from file VOL: CAL.TSK. 


Load a task from the paper tape 
reader punch device. 


mo SE, a See 


2230 


LOG COMMAND 


The LOG command logs all user input and MTM responses to a 


spec 


Form 


Para 


2=50 


ified fd. 


ats: 


NOCO 


LOG [fa] |, 


copy 


SET L0G [f4] | 


meters: 


fd 


COPY 


NOCOPY 


PY n 
td 
+5 
N 4 n 
t 
CaPpr ie 


is the file descrisptor of the log file or 
device. If no fd is specified, logging is 
terminated. It fd is a file, it must be 
mreviously allocated. Files are assigned £EWO 
Privileges so that logged output is added to 
the end of the file. If a log is active when 
another LOG command is entered, the old log is 
closed and the new one is initiated. 


specifies tuat all output is written to both 
the terminal and the log device. 


epecities that all output (except messages) is 
written to the log device and not to the 
terminal. 4essages from other users and the 
Operatcr are written to both the terminal and 
the log device. If this parameter is omitted, 
COPY is the default. 


is a decimal number from 0 through 65,535 
specifying the number of lines after which the 
user log file is to be checkpointed. I* this 
parameter is omitted, the default is 15 lines. 
If n is specified as 0, no checkpointing will 
Occur. 
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Functional Details: 


The LOG command and the SET LOG command are the same. The 
command can be entered either way, and both formats perform the 
same functione 


Checkpointing is only meaningful for indexed tiles on disk. The 
LCG command can be entered in command node, task loaded mode, and 
task executing mode. 


Examples 


LOG LOG.FIL,COPY,10 
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MESSAGE 


The 


MESSAGE COMMAND 


MESSAGE 


Format: 


MESSAGE 


Parameters: 


Functional Details: 


userid 


message 


command sends a message to a specified user. 


| 


40 o 


f 
userid 


OPERATOR 


A0 


qm 7 


gh" wat 


hessage 


ce yo ole 


is the name of the user the message is being 
sent td-. This id can b@ obtainei from the 
DISPLAY USERS command. A userid of .OPERATOR 
senis a message to the system console. 


is the text of the message that the user wants 
to send. 


The user receiving the message receives the userid of the sender 
as well as the nessage. 


This 


connani cin 


and task executing 


Example: 


The 
The 


he 


following 


he 


entered in command node, task leaied azote, 
mode. 


message is sent to userid “AVE” trom userid “IK". 


format of the message sent is: 


tormat of 


BELLO MIN USER 


the message received is: 


TR=HELLO MIM USER 
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2-32 MODIFY COMMAND 


The MODIFY command modifies the contents of a memory location in 
the loaded task. 


Format: 


data ; 
MODIFY address, [,dataz,eo«,datay] 
) ¢ 


Parameters: 


address is the halfword boundary adiress at which the 
contents of memory are to be modified. 


data is a data field consisting of zero to four 
hexadecimal digits that represent 32 halfwor? 
to be written into memory starting at tne 
location specified by addresse Any string of 
data less than four characters is 
right-justified and left-zero filled. ff the 
comma is entered but data is omitted, OO i353 
entered into one halfword. 


Functional Details: 


This command causes the contents of the halfword location 
specified by address (modified by any previous BIAS command) to 
be replaced with data. The modify address must be aligned on a 
halfwerd boundary. 


The MCDIFY command can be entered in task loaded mode and task 
executing mode. 


Any segment (impure, shared, or task common) to which a u-task 


has write access can be modified. Only the impure segment can be 
modified for an e-task. 
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Examples: 


BIAS 0 


MOD 12F0,4,0,4,0 


MOD DOO00,4 


Modifies four halfwords at location 
12F0 to contain Q008 49009 0004 
Q000. 


Modifies the first halfword of the 


task common linked to the task using 
segment register D to 4. 
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2.33 OPTIONS COMMAND 


The OPTIONS command allows an MIM user to change the task options 
of the currently loaded task.e 


Format: 


QPTIONS [- NRESIDENT] 


2VYCCONTINUE 
Parameters: 


RFEAUDSE specifles that the task is to pause after any 
arithmetic fault. 


RFCONTINUE specifies that if tne arithmetic fault (AF) 
trap enable bit is set, a trap is taken. If 
+he bit is not set, the task continnes after 
an arithmetic fault occurs, and a nessage is 
sent te the log device. 


SVCPAUSE specifies that SVC 5 is treated as a1 illegal 
SVC (applies to background tasks only). If an 
SVC 6 i418 executed within a background task, 
the task is paused. 
CVTCONTINUE epecifies that SVC 6 is treated as a NO-OFrF 
(applies to background tasks only). If an SVC 
é is executed within a background tasx, the 
task Le continued. 
NONRESIDENT specities tnat the task is to be removed from 
memory at end or task. 
Functional Details: 
The CPTIONS command can be entered in task loaded mode. 


Examples 


OPT AFC,SVCC 
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2-34 PAUSE COMMAND 


The PAUSE command pauses the currently running task. 


Format: 


PAUSE 


Functional Details: 


Any I/0 proceed, ongoing at the 
allowed to go to comvoletion. 
tack is dormant or paused at the 


The PAUSE command can be entered 
executing mode. 


time the task is paused, is 
This command is rejected if the 
time it is entered. 


in task loaded mode and task 
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2-35 PREVENT COMMAND 


The FREVENT command suppresses either messages or the hyphen (-) 
prompt while an interactive task is running. 


Format: 
MESSAGE 
PROMPT 
PREVENT 
EITM 
SVYARIABLE 


If a user did not input any of these parameters the terminal will 
receive both messages and (-) prompts. The hyphen prompt 
indicates that either a task or CSS is executing. 


Parameters: 


MESSAGE prevents other MIM users from being able to 
send nessages to the user terminal. 


PROMPT suppresses the printing of the hyphen (-) 
rrompt during task executing mode. 

ET™ Supresses the display of end of task message. 

SVARIABLE disanles variable processing on 2 per user 
basise 


Functional Details: 


If the 4TM system includes variable support and the SVARIABLE 
parameter is entered, the overall performance of FTM increases. 
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22-36 PRINT COMMAND 
The PRINT command sends the file to be printed to the Spooler for 
Subsequent printing. 
Format: 
PRINT fd (,DEVICE=pseudo device] [,copres=n] (,DELETE] [,vFCc] 


Parameters: 


fd is the name of the file to be printed. 


DEVICE= rseudo device specifies the print device. If 
this parameter is omitted, output is directed 
to any available print device. 


COPIES= n allows the user to specify the number of 
copies of the file fd to be output. From 1 to 
255 copies can be nadee IF this argument is 
omitted, one copy is the default. 


DELETE specifies the file fi is to be deleted after 
the output operation is completed. Tf this 
argument is omitted and the file is not a 
spool file, the file is retained. 


VEC specifies that vertical forms control is in 


use. Currently, the card punch driver does 
not Suppert VFC. 


Functional Details: 
Tf the spool option was not selected at sysgen time, this command 


results in an error. 


The PRINT command can be entered in command mode, task loaded 
mode, and task executing mode. 
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2-37 PUNCH COMMAND 
The PUNCH command 1 
file is to be punch 
Format: 


PpuncH fd [, DEVIC 


Parameters: 


COPIES= 


ndicates to the Spooler that the specified 
ed. 


E=pseudo device] [,copzreS=n] [,DELETE] [-VFC] 


is the name of the file to be punched. 


pseudo device snecifies the name of the pseudo 
output device. If the DEVICE= parameter is 
omitted, punch output is directed to any 
available punch device. 


n is the nunber of copies desired. From 1 to 
25 ccecples can be made. If the 
COPIES= parameter is omitted, only one copy 


{2S Dut puts 


DELET® 


Functional Details: 


If the spool option 


specifies that the fd is to be deleted after 
the cutput operation is performed. If 
omitted, the tile is retained. 


specifies that vertical forms control is in 


use. Currently, the ccari punch driver does 
not suppcrtt VFC. 


was not selectea at sysgen time, this commani 


will result in @n error. 


The PUNCH command c 
mode, and task exec 
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an be entered in command node, task loaded 
uting mode. 
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2-38 RENAME COMMAND 


The RENAME command changes the name of an unassigned, direct 


access file. 


Format: 


PENAME oldfd,newftd 


Parameters: 
oldtd is 
be 


newfd is 


Functional Details: 


The volume id field of 


the current file descriptor of the file to 
renamed. 


the file descriptor of the renamed file. 


the new file descriptor (newfd) may be 


cmitted. A file can only be renamed if its write and read 


protection keys are 0 


(X°0009'"). 


The RENAME command can be entered in command mode, task loaded 
mode, and task executing mode. 


Examples 


REN VOL: AJM.CUR,AJM.NEW Renames file AJM.CUR to AJM.«NEW on 


2°60 


volume VCL. 
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2-39 REPROTECT COMMAND 


The REPROTECT command modifies the protection keys of an 
unassigned, direct access file. 


Formats: 


REPROTECT fd,new keys 


Parameters: 


fd 


new keys 


Functional Details: 


is the file descriptor of the file to be 
reprotected. 


is a hexadecimal halfword whose left byte 
Signifies the new write keys and whose right 
byte signifies the new read keys. 


Uncenditionally protected files can be conditionally reprotected 


or unprotected. 


The REPRCTECT command can be entered in command mode, task loaded 
mode, ani task executing mode. 
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2-40 REWIND AND RW 


COMMANDS 


The REWIND and RW commands rewind magnetic tapes, cassettes, and 


direct access files 
Format: 


REWIND [£d,] lu 
or 


RH [¢d,] lu 
Parameters: 
td 


lu 


Functional Details: 


is the file descriptor of the device or file 
to be rewound. 


is the logical unit to which the idievice or 
file is assigned. If lu is specified without 
fd, the operation is performed on the lu 
regardless of what is assigned to it. 


The REWIND and BW commands can be entered in task Loaded mode. 


Examples: 


FEW 1 Causes the file or device assigned 
to lu 1 to be rewound. 
REN M3CO:AJM.0RPRJ,4 Causes file AJM.OBJ, as assigned to 


lu & on volume M300, to be rewound. 
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2-44 RVOLUME COMMAND 


The RVOLUM® command enables an MIM user to allow/disallow access 
to a privately owned disk. 


Formats: 


RYOLUME voln, 


Parameters: 


voln 


ADD 


actno 
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RW RW 
actno, x gece sACtNO 266 \ 
RO 


RG 
ADD, 
RW 
Au / 
RS 
RW RW 
actno, z geoee aC tNnO 566 / 
Ro RO 
REMOVE, 
RW 
ALL |/ 
BO 
actno 
USERS eo d€actnoy, - actno) 
Q~ 255 


is the volume name of the restricted disk. 


indicates that tne specified accounts will 
have access to the restricted disk. 


is a decimal number from O through 255 
indicating the accounts allowed/iisallowed 
access to the restricted disk. If ALL is 
specified, accounts © through 255 have access 
to the restricted disk. 


RW indicates that the specified account has 
read/write access to the restricted disk. If 
this argument is omitted, only the default is 
read. 


FO indicates that the specified account has read 
only access to the restricted disk. 


REMOVE indicates that the specified accounts ire 
disallowed access to the restricted disk. If 
ALL is specified, all accounts having access 
to the restricted disk are disallowed access 
with the exception of the owner's account. 


USERS displays all accounts having access to the 
restricted disk along with the access 
privileges. 


Functional Details: 


A disk marked on as a system disk is treated as a restricted 
disk. Account number 255 is the ownere 


The owner of a private disk can allow/disallow other MIM users, 
the systen operator, and other ncn-MTM tasks access to the 
restricted disk. 


If an owner enters a REMOVE parameter specifying a private 
account, access will be denied to the disk; the owner can still 
add accounts, remove accounts, and display accounts that have 
access, alongs with the respective access privileges. 


For a user with PW access to a restrictei disk, accessing 
private, group, and system files is exactly the same as accessing 
files on any other disk. 


For a user with RO access to a restricted disk, accessing group 
and system accounts is tne same as accessing files on any other 
disk. Files within the user's private account can only be 
assigned SRO or ERO. The user cannot allocates, rename, 
reprotect, or delete any files. 


Once a restricted disk is dismounted by the system operator, any 
accounts that once had access no longer have access privileges. 
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Examples: 


RVOL FIXD,U 


4/RW 2O0/RW TTS RA 82RW 
KVOL FIXD,A,ALL 
RVOL FIXD,U 
O/RO 1/RO 27RC 3/RO 
7/RO 8/RO 9/780 10/RO 
1TU/RO 15/F0 16/RO 17/RO 
252/P0 253/P0 2£4/R0 255/RO 
RVOL FIXD,&, ALL 
RVOL FIXD,U 
82/RW 
RVOL FIXD,A,ALL/RW 
RVOL FIXED, 
O/Rw 1/ EW 2/ RW 3/RW 
7T/ RW R/RW 9/Rd 10/RW 
V/s 15/Ph 16/7 RW 17/RW 
252/ RW 253/kKW 254/KW 255/RW 


RVOL FIXCD,R,ALL 
RVCL FIXD,JY 
B2/Rad 
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4/RO 
11/R0 
18/R0O 


4/RW 
11/RW 
18/RH 


5/RO 
12/RO 
19/RO 


5/RW 
12/RW 
19/RW 


6/RO 
13/RO 
20/P0 


6/RW 
13/28 
ZO/ RW 


2e42 SEND COMMAND 


The SEND command sends a message to the currently selected task. 


Formats 

SEND message [3] 
Parameters: 

message is a 1i- to S4-character alphanumeric string. 
Functional Details: 


The message is passed to the selected task the same way as an SVC 
6 send message. Following standard SVC 6 procedures, the message 
consists of an 8-byte taskid identifying MTM as the sender, 
followed by the user-surplied character string. The message 
passed to the selected task begins with the first nonblank 
character ‘*ollowing SEND and ends with a carriage return (CR) or 
semicolon (;) as a line terminator. A message cannot pe sent to 
a task currently rolled out. 


The receiving task must have intertask message traps enabled in 
its TSW ard must have an established message buffer area. Refer 
to the OS/32 Sunervisor Call (SVC) Reference Manual for wzxnore 
information on SVC 6. 
The SEND conmand can be entered in task executing mode. 
Example: 

SEND CLOSE LU2,ASSIGN LU3 


The following is received by the task: 


oMTM CLOSE LU2, ASSIGN LU3 
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20-43 SIGNOFF COMMAND 


The SIGNOFF command terminates the terminal session. If a user 
Signs ofr when a task is loaded, the task is cancelled. 


Format: 


no GNOFF 
Functional Details: 


When a terminal user signs cff the system, these messages are 
displayed: 


ELAPSED TIME=hhi:mm:ss CPUTIME=utime/ostime 
SIGNCN LEFT=hh:mm:ss CPU LEFT=hhs:mm:ss 
TIME OFF=mm/dd/yy hhemmsss 


The SIGNOFF command can pe entered in command mode, task loaded 
mode, and task executing mode. [It cannot be followed by another 
command on the same command line. 


Ne 


2044 


SIGNON COMMAND 


The SIGNON command allows a user to communicate with MIM. No 
commands are accepted until a valid SIGNON command is entered. 


Format: 


C~ 1 i. 


Parameters: 


userid 


actno 


password 


ENVIRONMENT= 


fd 
SIGCNON userid,actno,password |,ENVIRONMENT= 


NULL[:] 


CPUTIME=maxtime] 


»classid=ijiocount, [+++-classid=iocount 3a] 


is a 1- to 8-character alphanumeric string 
specifying the terminal user's identification. 


is a 3-digit decimal number between 1 and 250 
specifying the terminal user's account number. 


is a 1- to 12-character alphanumeric string 
specifying the terminal user's password. 


fd is tne file descriptor specifying an 
existing file that will establish the user's 
environment at Signon time. 


NULL specifies that the signon CSS routine, 
USERINIT.CSS, should be ignored and the user 
will establish the environment at signon time. 


If the entire keyword parameter is omitted, 
MTM searches all online disks for the signon 
CSS procedure USERINIT.CSS/P. The systen 
account, oon the system volume, is searched 
last. Lf US@SRINIT.CSS is found, MIM calis the 
CSS and executes the routine. If it is aot 
founi, MTM enters command mode. 
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~ 


CPUTIME= 


classid= 


Functional Details: 


The SIGNON command 


Maxtime is a decimal number specifying the 
maximum CPJ time to which the job is limited. 
If this parameter is omitted, the default 
established at sysgen time is used. If 0 is 
specified, no limits are applied. The 
parameter can be specified as: 


mmmmnsss 
hhhh:mm:ss 
ss¢s 


is one of the G“-character alphanumeric 
mnemonics specified at sysgen time associated 
with each specified device or file class. 


jocount is a decimal number specifying the 
maximum number of I/0 transfers associated 
with a particular device class to which the 
job is limited. If this parameter is omitted, 
the default established at sysgen time is 
used. If 9% ais specified, no limits are 
applied to that class. 


cah pe entered in command mode. It cannot be 


followed by another command on the same line. 


When ENVIRONMENT=NULL is specified, the colon is optional. This 
allows the user the ability to specify the null device (NULL:). 


Examples: 


SIGNON ME,12,PASSWD 


SIGNON ME,118,SW¥DOC,ENV=NULL 


SIGNON ME,118,SWDOC,ENV=XY2 
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2-45 START COMMAND 


The START command initiates execution of a dormant task. 


Format: 


START 


Parameters: 


address 


parameter 


Functional Details: 


address 


transfer address. 


(parameter ;,...,parametera] 


specifies the aidress at which task execution 
is to begin. For user tasks, this is not a 
physical address but an address within the 
task’s own program. For executive tasks, it 
is a physical address. [If address is omitted 
or is 0, the loaded task is started at the 
transfer address specified when the task was 
established. 


specifies optional parameters to be passed to 
the task for its own decoding and processing. 
All user specified parameters are moved to 
memory beginning at JTOP. If no parameters 
are specified, a carriage return is stored at 
NTOP. 


The START command can be entered in task loaded mode. 


Examples: 


ST 138 Starts the currently selected task 
at X°138°. 
ST 100,NOSEG,SCRAT Starts the currently selected task 


St 7 TOCO,RRe 


279 


at X'100° and passes NOSEG,SCRATI to 
the task. 


Starts the currently selected task 


at transfer aidress and vasses 
1000,A8C to the task. 
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2-46 TASK COMMAND 


The TASK command maintains CSS compatibility of MTM to the 
operating system. No specific action is performed by this 
command. 


Formats 


taskid 
TASK 
ez BGROUND 


Parameters: 


taskid is the name of the taskid that has been loaded 
into the foreground segment of memory. 


eBGRSCUND indicates that the task has been loaded as a 
background task. 


Examples: 
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2047 TEMPFILE COMMAND 


The TEMPFILE command allocates and assigns a temporary file to an 
lu for the currently selected task. A temporary file exists only 
for the duration of the assignment. When a temporary file is 
Closed, it is deleted. 


Format: 


TEMPFILE lu, 


Parameters: 


lu 


CONTIGUOUS 


fsize 


INDEX 


lrecl 


bsize 


CONTIGUOUS, fsize 


lrecl bsize isize 
INDEX |, / / 
426 q 1 


is a decimal number specifying the lu number 
to which a temporary file is to be assigned. 


specifies that the file type to be allncated 
is contiguous. 


is a decimal number specifying the total 
allocation size in 256-byte sectors. This 
size can be any value up to the number of 
contiguous free sectors existinz on the 
scecified volune at the time the command is 
entered. 


epecifies that the file type to be allocated 
is indexed. 


is a decimal number specifying logical record 
length in bytes. It cannot exceed §5,535 
bytes; its default is 126. 


is a decimal number specifying the number of 
256-hbyte sectors contained in a physical block 
to be used for buffering. If bsize is 
omitted, the derault value is 1.2 bsize cannot 
exceed the naxinum block size established at 
Ssysgen time. 
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isize is a decimal number specifying the index block 
size in 25€-byte sectors. If isize is 
omitted, the default value is 1. isize cannot 
exceed the maximum block size established at 
sysgen time. 


Functional Details: 


A temporary file is allocated on the temporary volume. 


To assign this file, sufficient room must exist in system space 
for three buffers, each of the stated size. Therefore, if bsize 
or isize is very large, the file cannot be assigned in some 
Situations. A maximum block size parameter is established in the 
system at sysgen time. The bsize and isize cannot exceed this 
constante 


The TEMPFILE command can be entered in task loaded mode and task 
executing mode. 


Examples: 
TE 2,CO,4€uU Allocates, on the temporary volume, 
a contiguous file with a total 
length of 64% sectors (16kb) and 
assigns it to the loaded task‘'s lu 
Ze 
TE 14,145,126 Allocates, on the temporary volume, 


an index file with a logical record 
length of 126 bytes. The buffer 
sive and index block size ijiefault to 
one sector. The tile is assigned to 
lu 18 of the loaded task. 
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2248 VOLUME COMMAND 


The VOLUME comnand sets or changes the name of the default user 
yvolLumee [It may also be used to query the system for the current 
nares associated with the user system, roll, spool, or temporary 
volume. 


Formats: 


YOLUME [voln] 


Parameter: 
voln is a Yecharacter volume identifier. If this 
Parameter is omitted, all current defauit 
uSEL, systen, roll, spool, and temporary 


volume names are displayed. 


Functional Details: 


Any commands that do not explicitly specify a volume name use the 
default user volume. No test is made to ensure that the volume 
is actually online at the time the command is entered. If voln 
is not specified, the names of the current default volumes are 
Output «90 the user console. 


The a@default user volume is initially set to the syst2m volume 
when the user signs on. The VOLUME command can be entered in 
command mode, task executing mode and task loaded mode. 


Example: 


VOL 
USR=MTS SYS=MTM SFL=M678 TEM=4%301 RVL=MT 
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2-49 WFILE COMMAND 
The WFILE command w 
and direct access f 
Formats: 

WEILE [£d,] lu 
Parameters: 


nano 


lu 


Functional Details: 


rites a filemark on nagnetic tapes, cassettes, 
iles. 


is the file descriptor of the file or device 
to which a filemark is to be written. 


is the lu to which the device or file is 
assigned. If lu is specified without fd, the 
operation is performed on the specified lu 
regardless of what is assigned to it. 


The WFILE command can be entered in task loaded mode. 


Examples: 


WF 1 


WEF M3003 AT”. 08J 
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Causes a filemark to be written on 
the device or file assigned to lu 1. 


7H Causes a filemark to be written on 
file AJM.O3J, which is assigned to 
lu & on volume M300. 
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2.50 XALLOCATE COMMAND 


The XALLCCATE command is used to create a direct access file. 


Format: 


XALLOCATE £4, 


Parameters: 


fd 


CONTISUOUS 


fsize 


INDEX 


lrecl 


keys 
CONTIGUCUS,£fsize | i 


lrecl 
LNDEX |} | } 
42% 


gays 


SY 
san} 


lrecl bsize keys 
tS HHT Ls HIT Home! 
$%. gone 


is the file descriptor of the file to be 
allocated. 


specifies that the file type to be allocated 
1s contiguous. 


is a decimal nurber indicating file size which 
is reguired for contiguous files. Tt 
specifies the total allocation size in 
256-byte sectorse This size may be any value 
up to the number of contiguous free sectors 
existing on the specified volume at the time 
the command is entered. 


specifies that the file type to be allocated 
is indexed. 


is a decimal number specifying the logical 
record length of an indexed file or 
communications device. Lt cannot exceed 
65,9535 bytes. Its default is 1246 bytes. I[t 
May opticnally be followed by a slash (/) 
which delimits lrecl fron bsize. 
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bsize is a decimal number specifying the number of 
25€~-byte sectors contained in a physical block 


to be used for buffering. This parameter 
cannot exceed the maximum block Size 
established at sysgen time. If bsize is 


omitted, the default value is one sector. 


isize is a decimal number specifying the indexed 
block size. If isize is omitted, the default 
value is one sector. Like bsize, isize cannot 
exceed the maximum block size established at 
sysgen time. 


ITAM specifies that the device to be allocated is 
a communications device. 


keys Strecifies the write and read protection keys 
for the file. These keys are in the form 95f 
a hexadecimal halfword, the left byte of which 
Signifies the write key and the right byte the 
read key. If this parameter is omitted, both 
keys default to 0. 


Functional Details: 


The XALLOCATE command is different from the ALLOCATE command. If 
the fd to be allocated is a device name instead of a filenane, a 
DFL-ERK TYPE=VOL ‘Securs. Ir a filename is e¢pecified, the 
XALLOCATE command reallocates the file. If fd is an existing 
file, it is deleted and reallocatea. If fd does not exist, it is 
allocated. This command permits the user to have CSS procedures 
that allow a file or device name tc be specified. 


The XALLOCATE command can be entered in command mode, task loaded 
mode, and task executing mode. 
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{| XDELETE | 
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2-51 xXDELETE COMMAND 
The XDELETE command is used to delete one or more files. If the 
file does not exist, no error is generated. 
Format: 
XDELETE fd, [-fd2.-.,fdg] 


Parameter: 


pagee is the file descriptor of the file to be 
deleted. 


Functional Details: 


file can only be deleted if it is not currently assigned to a 
sk ani its write and read protection keys are 0 (X'0000'). 


A 
ta 
Example: 


XDEL FIXD:08S323240.817, RADPROC.FIN 
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CHAPTER 3 
PROGRAM DEVELOPMENT 


321 INTRODUCTION 


This chapter is written as a program development tutorial session 
for new to intermediate users. The program development commands 
ehatle you to easily create a program and modify, maintain, and 
execute it from the terminal. 


3.2 CREATING A SOURCE PROGRAM 


To enter a source program that will exist ina single source file 
(language environment), enter a program development language 
command with a user-specified filename. Source filename 
extensions are program supfrlied and language dependent. The 
language command entered must he consistent with the language of 
the source file. When a language command is entered, a file is 
allocated with the user-specified filename and program-supplied 
filename extension, and the editor is loaded and started. 


Table 3-1 lists the program development language command syntax 
and program~supplied filename extensionse 


TABLE 3-1 PROGRAM CLEVELOPMENT LANGUAGE COMMANDS 


(using orftinizing 
compiler) 


| | PROGRAM 
| | | DEVELOPMENT { 
| LANGUAGE | COMMAND SYNTAX [FILENAME EXTENSIONS | 
| oo er OT To So SF SKS Oe a On Sa a a Se << > <= <=. oa a | 
| CAL/322 { CAL [l{veln:] filename] | CAL 
| | | | 
| CAL Macro/32 | MACRO {[[veln:] filename] [| .MAC | 
| | | 
| FOFTKAN VII { FORT [fvolin:] filenane) | FTN | 
{ | Cusing development | | 
| | compiler) | | 
7 | | 
{ FORTRAN VII | FORTO {[[{veln:] filename] | .FTN | 
| | | | 
| | | 
| | | 
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TABLE 3-1 PROGRAM DEVELOPMENT LANGUAGE COMMANDS (Continued) 


| | | PROGRAM | 
| | | DEVELOPMENT | 
| LANGUAGE | COMMAND SYNTAX [FILENAME EXTENSIONS | 
{ SSS SS SST SSST SSS SS VSS SSS SV SSS SVS SS TVS SSS SS SS STS SSS ST STS SS SS ST SST TS ST ST STS TST = { 
| CCBCL |} CCBCL [(f{veoln:] filename] | ~CBL | 
| | | 
| REPORT | FPG {[voeln:}] filename] | RPG | 
| FRCOGRAM | [ 
| GENERATOR | 
| | | | 
{| FASCAL | PAS [{veln:] filename] | «PAS | 


Program development language commands automatically specify that 
certain processes be set up for the remainder of the development 
effcrt. These processes are: 


e Assignment of the standard source file language extensions 

e The comriler or assembler to be used 

@® The standard Perkin-Flmer run time libraries to be linked 

e The language tab character, a back slash, (\), and tab 


settings pertinent tc the specified language, displayed when 
the editor is entered 


These automatic specificaticns free you from constantly having to 
remember them. The user-supplied filename with the 
progran-supplied extension will 1rdentify the source file 
threughout the program develcpnent session. 


Once the editor is loaded and startea, the full range of Edit 


commands are available tc create the source file. See the 0S/32 
Edit User Guide. 


Examples 


*FORT PROG! 
** NEW PROGRAM 


-ED 1 

-G PROGT.ETN 
a0: TR = Negie ls 
=<.-CCM = CCN: 
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(edit session) 


PSAVE* 

PEND 

-WCRK FILE = M67E: PROG1.000/P 

-RENUMBERED INPUT FILE AVAILABLE, M67B: PROG1.FTN/P 


In this example, the FORTRAN language commani entered with a 
user-sucrlied filename allocates an empty file, PROGI.FTN, and 
loads and starts the editcr. The FORTRAN tab settings are 


displayed. The filename you specify is called the current 
program and is alwavs accessed and/or executed if vou do not 
Specifv another filename. You can start to enter your program 


after these messages are displayed: 


** NEW PPOGRAM 
sae oy Ba 
? 


You can also create a source file by entering a language command 
without a filename. Then enter the EDIT command with a filename. 
The EDIT command allocates a file and loads and starts the 
editor. You can employ all of the Edit commands to create your 
source file. 


Example: 


w FORT 
TEDL. FRCG4 
~EDID = PROGCT.sFIN 


(edit session) 


PORVE*™ 
PEND 


The FORT command creates the language environment. The EDIT 
command entered with PROG? loads and starts the editor and 
allocates PROG1.FTN for the source file that will be created via 
the Edit commands. PROG1.FIN is saved and the edit session is 
ended. 
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3e2-1 Creating a Data File 


Te create a data file, save the source program file to iisk, and 


clear the edit buffer by deleting all lines currently in the 
buffer. 


Example: 


2oAVE* 
PUELEL SE. A> 
DAF 


(use the editor te create PROG1.DTA) 


PSAVE FROG1.DTA 
> END 


In this example, PRCG1.FTN is saved and then cleared fron the 
edit butfers The Edit APPEND command allows data to be entered 
in the data file. The data file is saved, and the edit session 
is terminated with the END command. 


3-3 EXECUTING A PROGRAM 


The program development EXEC command loads and runs the current 
program. 


Example: 


SEALER 
**® EXECUTION OF PROG1.°TN FOLLOWS: 
“END OF TASK CODE=9 


This example assumes that PROGI.FTN already exists as the current 
programe The EXEC command loads and runs the current program, 
PROG1.FTN, and displays a zero end of task code. 


3-4 MODIFYING A PROGRAM 


To modify your program, enter the appropriate language command 
with the filename of the source file to be modified. anter the 
EDIT command to access the editor. 
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Examples 


*FORT PROG1 
* EDIT 


(edit sessicn to modify PROG1) 


DEANE 
PEND 


In this example, the FORTRAN Language command 1s entered with the 
filename PROS1. The editor is accessed via the EDIT command, and 
the name of the current program is displayed. The editor is used 
to modify the scurce file, PROG1. 


3-5 RE-EXECUTING A MODIFIED PROGRAM 


khen the EXEC command is issued, the source program is compiled, 
linked, and executed, creating object and image modules. If the 
source file is subsequently modified, the dates assigned to the 
Dreviouslvy compiled object and voreviously linked image modules 
wiil not be current. 


Dates and times are assigned to source, object, and image modules 
when they are created. The dates are in Julian format and are 
stored in the system directcry. 


The FXFC command causes the object and image modules to be 
datechecked. They are then compiled and/or linked if they are 
out of date. The FXEC command then loads and runs the image 
program. 


Example: 


*EXEC PROG! 

~FORTRAN PROG1.FIN 

“END OF TASK CODF=0 

-~LINK PRCG1.0BJ 

-~END OF TASK CODE=0 

** EXECUTION OF PROG1 FOLLOWS: 
“END OF TASK CODE=90 


This example assumes that PROG1.FTN already exists. The EXEC 
command, entered with PROG1, compiles, links, anc then executes 
the image program. A zero end of task code is displayed after 
each process. 
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The program development RUN command can also be used t35 execute 
a progran. The FUN command does not datechecxk, compile, or link. 
It simply runs a program that was already compiled and Linked. 


Examples 


*RIUN PROG1 
** EXECUTION OF PROG1 FCLLOWS: 
-END OF TASK CODE=9 


If the EXEC or the RUN command is entered without a filename, the 
current program is executed. If there is no current progran, 
this message is displayed: 


** CURRENT PRCGPAM NOT SPECIFIED 


If vou only want to cecmpile a progran without linking or 
executing it, the program development COMPILE command can be 
used. The program development COMPLINK command compiles and 
links a program, if necessary, but does not execute it. The 
nrogran development LINX commani links the object program but 
de2s not execute it. These commands are exolained fully in their 
respective sections. 


3e6 EXECUTING MULTIPLE PROGRAMS AS A SINGLE PROGRAM 


If a source program exists in multiple source files (multi-module 
environment), you must include the file descriptors (fd) of each 
source file in an envirenment descriptor file (EDF). The EDF 
retains the identity of all the source files in the multi-anodule 
enviroanent that will be used to create a vorogram. 


wher you enter the program development ENV command, you indicate 
that your source progran exists in more than one file and is to 
be created in a multi-nodule ‘environment. The ENV command 
creates the multi-module environment and allocates an EDF to 
contain the fds of the source files. 


Example: 


*ENV SLLPROG 
we NEM ENVIRONMENT 


In this example the ENV command with the user-specifiea EDF name, 
ALLPPOG, creates the multi-module environment. 
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The extenstion to the EDF filename is program supplied. Ir you 
enter it, an error is generated. The user~specified or default 
volume is searched for ALLPROG. If it is not found, an empty 
file naned ALLPROG is allocated, and the message, NEW 
ENVIRONMENT, is displayed. The EDF is now ready to receive the 
fds of the multiple source files. The program development ADD 
command is used to add source program fds to the the multi-moduile 
environment. 


Examples 


*ENV ALLPROG 

** NewW ENVIRONMENT 
*ADD PROGIT.FTN 
*ADD PPOG2.CBL 


The multicmodule environment is created and an EDF, ALLPROG, is 
allocated via the ENV command. The ADD command adds the fds, 
PPCG1.-FTN and PROG2?.CBL, to the multi-module environment. 


Wher the ADD command is entered with a user-specified fd, the EDF 
is searched for that fd. If tne fd does not already exist in the 
multi-module environment, it is added. If it already is in the 
multi-module environment, this message is displayed: 


ee PLL Va CONNER LCr @ ENT or Nod ADDED 


You must rename the file cr retusve the existing entry from the 
environment. 


The procram development LIST commanidt displays the fds in the 
multi-module environment, and the program development PEMOVE 
command removes fds from the multi-module environment. 


Example: 


ae ep es 

** CURRENT FNVIRONMENT = ALLPROG 
~PROG1.FIN 

-PROG2.CBL 

*REMOVE PROG? 

ie FB Se | 

** CURRENT ENVIRONMENT = ALLPROG 
-PROG1.FIN 

w EXEC 

ee EXECUTICN OF ALLPPCG FOLLOdS: 
** END OF TASK COLDE=0 

> 
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The list conmand displays PROG1.FTN and PROG2.CBL as the fais in 
the multi-module environment. The REMOVE command removes PROG2. 
CBL and the LIST command displays’ the sontents oe the 
multi-module environment. The EXEC command runs the progran, 
ALLFRCG. 


If the ADD or PEMOVE command is entered without an fd or if the 
fd is incorrect, this message is displayed: 


ee SYNTAX EREC® 


Not all program development commands are available in both 
language and multi-module environments. Table 3-2 shows the 
commands that are available in the environments. 


TABLE 3-2 PROGRAM DEVELOPMENT 
COMMAND AVAILABILITY 


| |} LANG- | MULTI- | 
{ COMMAND { wJAGE |} MODYLE | 
| SSS Sw ae on a sw so an sn co an one SS sam ce | 
| ADD | {| x | 
| COMPILE | x | x | 
| COMPLINK | x | x | 
bY SOLT | x |} x | 
| ENV | | x | 
f EXFC | x { x | 
| LINX | x | x | 
{ LIST | | x | 
| PEMOVE | | x | 
{ FUN | x {| x | 
ie a command that is meaningful only in a multi-nodule 


environment is entered in a lanrtgcuage environment, this message is 
displayed: 


** NOT IN MULTI-MODULE ENVIRONMENT 


In order to re-accessS a scurce program, modify the source file, 
and include it in aA multi-emodule environment, enter tne ENV 
command followed by the EDIT command and use the editor to nodiry 
the source file. 
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Examples 


*ENY ALLPROG 

*ADD PROG1.FTN 

* List 

~* CURRENT ENVIRONMENT = ALLPRCG 
=PROG2ZeCEL 

-FROG1.FIN 

*EDIT PRCGI.FIN 

-EDIT PROG1.FIN 


(edit session) 


>SAVE* 

PEND 

ok 9. AS 

~PERKIN-ELMER Of/32 LINKAGE ELITOR 03/242 ROO-01P3 
-END OF TASK CODE = 0 

** EXECUTION CF ALLPRCG FOLLOWS: 
~2ND OF TASK COLE = .0 

=* EXSCUTLON OF PROG? FOLLOWS: 
SEND OF TASK COLE =: °0 

e® EARCUILCN CF PROG) FCLLOwS: 
“-2£ND OF TASK CODE = 0 

> 


The multi-module environment is accessed via the ENV command and 
the EDF name, ALLPROG. PROG1.FTN is added to the multi- module 
environemnt. The LIST command displays the filenames remembered 
in the EDF, The Edit command accesses the editor to modify 
PROG1. When the edit sessicn is ended,the EXEC command executes 
PRCG2 and FROG1, displaying a zero end of task code after each 
Successful execution. 


3-7 HOW TO RECOVER FROM ERRORS 
If an error cecurs in program compilation or execution, the 


process aborts, and a nonzero end of task code and an error 
message are displayed. 


Examples 


e* COMPILE ERRORS, LISTING (ON PRs 
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Program development makes it easy for the user to recover from 
GrrorSe Compile errors are printed in the listing of the source 
file containing the error. ‘ 
Use the editor to correct the error and re~execute the program. 
The EX®C command will recompile only the modified modules. 


In some instances the EXEC command will recompile a successfully 
compiled mcedule if the time between the creation of the source 
and object is less than one minute. 


See the OS/32 Link Peference Manual for an explanation of link 
error messages. 


3-8 ASSIGNING LOGICAL UNITS 


Pregaram development defines and sets global variables that are 
asscciared with particular devices. These devices have default 
legical unit (lu) assignments. The global variable names and 
settings are displayed when the user signs on. Table 3-3 shows 
the default variable names, their settings, and lu assignments. 


TABLE 3-3 PROGRAM DEVELOPMENT DEFAULT VARIABLE 
SETTINGS AND LOGICAL UNIT 


ASSIGNMENTS 
VARIABLE | ~S*&YSCLO@ICAL 
NAME | DEVICE {| UNIT 
ae fea lms | 
: asSysour , ION: | 2 | 
| ~acoSYSPet | pes : 3 . 
. aSSYSCOM | CON: | 5 : 
| aSSYSMSG | CON: . 7 7 


Before running a program, ensure that the default variable and lu 
settings are appropriate. To change any of the variable 


a» need 


settings, use the SSrT command. The inout device can be changed 
from the console (default) to a pre-allocated file. 


Example: 


*SSET @55 752" = FILE. Es 
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Listings can be sent directly to a file rather than to the 
Printer (default). 


Example: 


*SSET OSSYSFRT = FILE.OUT 


Any variable settings you change supercede the default variable 
Settings and are in effect until you change them again or sign 
Ott < 


You can also redefine global variables via the SGLOBAL command 
and then set their values via the SSET command. You can then 
assign their lus via the ASSIGN command. 


Examples 


*SGLOBAL @SSISFILE 
SSSET @SSYSFILE = SL LEsin 
"AS 1,FILEsIN 


The SGLOBAL command can also be used to assign lu 0 through lu 15 
by defining the dlu variable and setting the variable to the 
desired device or file. 


Examples 


*SGLOSAL alt 
*SSEL @LUT=CON: 


User-defined variables and their lu assignments supercede all 
other variable names and device lu assignments. They remain in 
efrect until you change them, sign off, or free them via the 
SFR EE commande 


Example: 


*AS1, FILE.IN 
*SFREE aL 
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The SGLOBAL command can also be used to specify 
parameters to be used with the RUN or EXEC command. 


Example: 


*SGLOBAL dSOPT( 32) 
*SSET @SOPT = “CROSS, SQUEZ’ 


In this example, start parameters are contained in the 
@SCPT(32), and supercede any other start parameters. 
3-9 PROGRAM DEVELOPMENT COMMANDS 


This section describes the functions cf each of the 
program developrent commands: 


e Ard 
e COMPILE 


@ CCMPLINK 


e PIT 

e ENV 

e@ EXEC 

e LINK 

e LIst 

@ REMOVE 
e FUN 


task start 


variable, 


following 
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3.9.1 ADD Command 


The ADD command adds the fds of source programs to the 
multi-module environment. These fds are remembered in the EDF. 
The ADD command is valid in the multi-module environment only. 


Format: 
ADD £4 [,cssprod] 
Parameters: 


£4 is the file descriptor of the source file 3 
he added to the multi-module environment. 


cssprod ies the name of the CSS procedure to be used 
woen nonstandard cceupilation is required. 


Functional Details: 


The ADD command causes the current EDF to be searched for the 
specified fd. If the specified fd is not found, it is added to 
the multi-module environment. Jf the fd currently exists in the 
environment, the following message is displayed: 


** TILENAME CONFLICT - ENTEY NCT ADDED 


If the fd is omitted, or is in an incorrect format, this message 
is displayed: 


** SYNTAX FRPOR 


lf the fd is entered without an extension, this message is 
displayed: 


ee EXTENSION ONLITED 
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The cssprod parameter must be used if the extension of the 
specified file differs from the language extensions listed in 
Table 3-1. If this parameter is omitted when you are using a 
nonstandard extension, the following messages are displayed: 


** NONSTANDARD FXTENSION 
** ALTERNATE CSS REQUIRED 


The alternate CSS cannot be specified by just a volume name. Le 
must contain at least a filename. 
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3.9.2 COMPILE Command 

The COMPILE command unconditionally compiles a source module and 
creates an object module if an uvo~to-date object module does not 
already exist in the language environment. The COMPILE command 
conditionally compiles when the ALL parameter is specified in the 


multi-emodule environment. The COMPILE command does not execute 
a Programe 


Language Format: 


voln: filename 
COMPILE 
user vain: current progran 


Multi-Module Formats: 


/ filename 


voln: 
COMPILE ALL 


user yolin: 
current program 


Parameters: 


voin: 1s a 1- +9 Yecharacter alphanumeric nate 
specifying the volume on which the source file 
resides. If this parameter is omitted, the 


default is the user volume. 


filename is a i= to S8e-character alphanumeric name 
Specifying the source file. If this parameter 
is Omitted, the current program is the 
default. 

ALL specifies that all files in the multi-module 
environment whose fds are remembered in the 
EDF are to be compiled, if necessary. ahen 


this parameter is specified, the COMPILE 
command conditionally compiles all the files 
that are in the multi-module environment. 
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Functional Details: 


A successful compilation ends with a zero end of task code. An 
end of task code other than zero indicates a compilation error 
that will be printed on the listing created as a result of 
compile. 


If the environment is null when you enter the COMPILE command, 
this message is displayed: 


** ENVIRONMENT NOT SET 


If a filename is not entered and a current program is not 
specified, this message is displayed: 


** CURRENT PROGRAM NOT SET 


If a specified filename does not exist, the following message is 
displayed: 


** file.fd NOT FOUND 


The CCMPILE command functions are illustrated in Figures 3-1 and 
3-26 
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SOURCE MODULE BEFORE COMPILE 


ALLPROG.EDF 


PROS2.eC3L| 


| 
{ 
| 
| 
| 
| | 

| -> | | 
| | 


wee ewes “GRP ee ewe Se see cue eee 


(PROG1.FTN]| [PROG1.0BJ | 


| | | | 
| 6/26 | | 6/20 | 


eeee----- 2 --------- NO 
EXECUTION 

[PROG2.CBL{ |PROG2.0BJ] 
| | | | 
| 6/20 { | 6/20 | 

{ ~ 

ema eer een, 

COMPILE 


Figure 3-1 COMPILE Command Functions in the Language 
Environment 
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SOURCE AND OBJECT MODULES BEFORE COMPILE ALL 


| 
->| 6/20 | 
ALLPROG.EDF 


->|PROG2.CBL]| |PROG2.0BJ| 


| | 
| 6/20 | | 6/15 | 


| | 
| | 
| | 
| | 
| | 
| | 
| | 
| 
| | 


SOUFCE AND OBJECT MODULES AFTER COMPILE ALL 


{PROG1.FTN | 
| | 
5/20 | 
{PROG2.CBL] {PROG2.OBJ| 
| (==?) | 
| 6/20 | | 6/15 | 

7 | 

eee eee e eT, 

DAT ECHECK 
|PROG1.FTN I {PROG1.0Bd| 
| ae a | 
| 6/20 | | 6/20 | 
eaee ene 0 nan --- NO 
EXECUTION 
{PROG2.CBL| |PROG2.O0BJ| 
[= es | 

| 6/20 | 6/20 | 

| ~ 

Cae ee eee 

COMPILE 


Figure 3-2 COMPILE Command Functions in the Multi-Module 
Environment 
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| COMPLINK | 


3.9.3 COMPLINK Command 


The COMPLINK command performs a conditional compile and a 
conditional link by datechecking source, object, and image 
modules in language and multi-module environments. rt “ais 
modules are up-to-date, this command does not perform any 
function. This command does not execute the progran. 


Language Format: 


voln: filename 
COMPLIN« | 
user voln: current program 


Multi-Module Format: 
CCMPLINK 
Parameters: 


voln: is a i- to Uecharacter alphanumeric name 


specifying the volume on which the source file 
resides. Bee this parameter is omitted, the 


cefault is the user volume. 


filename is a 1- to &-character alphanumeric nane 
specifying the source file. If this parameter 
ic omitted, the current oprogran is the 


default. Filename specification is meaningful 
in a language environment only. 


$ 


Functional Details: 


When the COMPLINK command is used in a multi-module environment, 
all the fds contained in the EDF are datechecked, compiled if 
necessary, and linked. 

If the specified ssurce file is not found, the COMPLINK sequence 
terminates, anda this message is diceplayed: 


we fd NOT FOUND 
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If you specify any arguments in a multi-module environment, this 
message is displayed: 


** TOO MANY ARGUMENTS 


The COMPLINK command functicns are shown in Figures 3-3 and 3-4, 


SOURCE, OBJECT, AND IMAGE MODULES BEFORE COMPLINK 


PROGU.CBL{ |PROGS.OBJ| |PROG4.TSK] 


| | | | | | 
| 6/20 [| {| 6415 [| { 6/15 | 


SOURCE, OBJECT, AND IMAGE MODULES AFTER COMPLINK 


|PROGU.CEL] |EROG4.OBJ}] |PROGS.TSK| 
| ; | | | 
| 6/20 | | 6/15 {| | 6/715 f 

~ ~ | 

eee Ree ee (eee eee | 

DATECHECK 

(FRCGU.CBL] |PRCG4.OBJ|] |PROG4.TSK] NO 
[=>] [->| | EXECUTION 
| 6/20 | | 6/20 | 4| 6/20 = 4f 

{ a Cn) 

Ee eee Ean Reet 

COMPILE LINK 


Figure 3-3 COMPLINK Command Functions in the Language 
Environment 
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SOURCE, OBJtCT, AND IMAGE MOLULES BEFORE COMPLINK 


| {| |PROG1.FTN| [PROG1.0BJ| 
| ; | {| | 
{[ALLPROG.EDFIJ->| 6/20 ft | 6/10 | 
| [ <-sSeSeess= ‘SSS 45sS= 
| | 

| i. . SSSSSss<s SSaeeses= 
| [->|FROG2.CBL] |PROG2.0BJ| 
| 6/6 | | 

| | | 6/20 | | 6/10 | 


SOURCE, OJSECT, AND IMAGE FILES AFTER COMPLINK 


[PRCG1.FTN| |PRCG1.CBJ] | 
| | | ->| | 
{ 6/20 f | 6/10 {  {ALLPROG.TSK| 
-<—-—S=-—==  =SeSeeee > | | 
Sees | ee ieee | | 
{PROG2.CBL{ {PROG2.OBJ{->| 
| I | — 6/8 
rE ~6/20 f | 6/19 { | | 
[= | 
Di ee ee ee ee | 
ATECKECK 
{[PROG1.°TN |[->{PROG1.033 [=> | 
, | { | | 
| 6/20 f of €/20 f | 
weer een ee eee [ALLPROG.TSK | NO 
ween ene we + l | EXECUTION 
| PROG2.CBLI->{FRCG2.0BJ{->| | 
| | | { | | 
| 6/20 | | 6/20 t | 6/20 | 
| a ms 
eee eee eee | Does eee tee eal 
COMPILE LINK 


Figure 3-4 COMPLINK Command Functions in the Multi-Module 
Environment 
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| EDIT 


3.9.4 EDIT Command 


The program development language commands load and start the 
editor for you to create a source or data file. You can also 
enter the EDIT command to create or modify a source or data file. 


Format: 


volns: filename 
EDI? 
user voln: current ohaaeel 


Parameters: 


voln: is a  1- to 4&echaracter alphanumeric nane 
specifying the volume on which the source file 
resides. If this parameter is omitted, the 


default is the user volume. 


filename is a  1- to 8-character alphanumeric name 
specifying the file to be created or eiited. 
If this parameter is omitted, the current 
program is the default. 


Fanctional Details: 


A language command entered with a filename loads and starts the 
editer if the file does not exist. However, if the language 
command is entered without a filename, enter the EDIT command 
with a fileneme to access the editor and create or modify a 
source file. 


If this command is entered ih a NULL environment, the tab 
character is set ani displayed, but the language tabs are not 
sete 

Té this command is entered with a filename not contained in a 
multi-module environment, this nessage is displayed: 


we STLENEME NOL IN ERVIRCNNENT 


lf this command is entered without a 
environment and there is no current 
disrlayed: 


** CURRENT PROGRAM NOT SPECIFIED 


If this command is entered without a 
current program in the multi-module 
current program is displayed: 


«fr 


FDIT - current program 


For informatin on the Fdit commands, 
OS/32 Edit User Guide. 
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filename in the multi-module 
program, this message is 


there iS a 
the name of the 


filename when 
environment, 


see Section 146624 or the 


| ENV | 
3.9.5 ENVY Command 
The ENV command entered with an ED® name creates the multi-module 


environment and allocates the user-specified EDF, if necessary. 
This command also can be used to clear the current environnent. 


Multi-Module Format: 


voln: filenane | 
ENV 
user voln: current program " 
NULL 
Parameters: 
voln: is a 1- to 4echaracter alphanumeric name 


specifying the volume on which the EDF 
resides. If this parameter is omitted, the 
default is the user volume. 


filenane is a I= to 8-character alphanumeric name 
svoecifying the EDF, filename. EDF. If this 
Parameter is omitted, the default is the 
current oregrame The EDF extension is 
automatically appended and must not be entered 
by the user. 


NULL clears the current environment. 
Functional Details: 


Tf the filename parameter is entered with an extension, this 
message is displayed: 


SP SLT AA 2RROR 


If the ENY command is entered without a@ parameter, the name of 
the current environment is displayed: 


*e® CURRENT ENVIRONMENT = XXXXXXXX 
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If the environment was not set or the NULL parameter was 
specified, this message is displayed: 


** NO CURRENT ENVIRONMENT 
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EXEC | 


3.9.6 EXEC Command 


The EXEC command datechecks source, object, and image modules in 
language and multi-module environments and compiles or links then 
if they are outdated. When the image program is current, it is 
loaded and run. 


Format: 


voln: filename 
EXEC [ “start parameters"| 


user voin: current progranr. 


Parameters: 


voln: is a  11*- to U4echaracter alphanumeric name 
specifying the volume on which the source file 
resides. If this parameter is omitted, the 


default is the yser volume. 


filename is a 1>- to é-character alphanumeric name 
specifying the program to be run. If this 
parameter is omitted, the current program or 
environment name is the default. 


"Start are parameters particular to the compiler 

rarameters”™ or assembler to be used. These parameters, 
usually specified with the operator START 
command, can now be specified with the progran 
development EXEC command. Start parameters 
must be entered with their beginning and 
ending quotation marks. 


Functional Details: 


When the EXEC command is entered in a multi-module environment, 
all modules contained in the EDF are compiled and linked if they 
are outdated. The task is then loaded and run. 


If start parameters are entered, they are invoked every time the 
task is executed. 
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Start parameters can also be specified by setting a variable, 


@SOPT( 32) with the SGLOBAL command. 


Example: 


*SGLOBAL @SOPT(32) 


Start parameters of up to 32 characters can be specified in 
SOPT variable, and they Supercede all other start parameters. 


the 
lf 


the start parameters are null and SGLOBAL aSOPT (32) is null the 


task is started without start parameters. 


EXEC command functions are shown in Figures 3-5 and 3-6. 


SCURCE, CBJECT, AND IMAGE MODULES BEFORE EXEC 


{PROG1.FTN{ |PROG1.0BJ] |PROG1.TSK| 


| | | | | | 
| 6/20 {| | 6/18 [| { 6/18 | 


SOURCE, OBJECT, AND IMAGE MODULES AFTER EXEC 


[PROG1.FIN| |PROG1.08J{ {PROG1.TSK| 
| i | | | | 
| 6/720 {| {| 6/18 | { 6/18 | 

- 1 | 

Seem ee este: (Poe Oe eRe ee ees | 

DATECHECK 

[PROG1.FTN| |PROG1.9BJ} |PROG1.TSK] 
1->] \->| [-> TASK 
[| 6/20 {| | 6/20 | { 6/20 #| EXECUTION 

| “| * 

Dc ee a | 

COMPILE LINK 


Figure 3-5 EXEC Command Functions in the Language 
Environment 
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SOURCE, 


Figure 3- 


OBJECT, AND IMAGE MODULES BEFORE =XEC 

l [->|PROG1.FTN{ |PROG1.0BJ| 
| | | i | 
{ALLPROG.EDF] | 6/20 | | 6/15 | 
| | saeeeewne  seennenn- 
| 

| ke irgcirs deca 
l [->|PROG2.CBL}] |PROG2.OBJ| 
| | | ; | | 
| | | 6720 | | 6715 | 


[PROG1.FTN]| |PROG1,03J| | 
} | |->j l. 
| 6/20 ! { 6/15 t | | 
eewewwne= en enn ne- {| ALLPROG.TSK | 
| | 
<<HS—S— Ss Steen | | 
|PROG2.CBL{] |PROG2.O0BJ}] | | 
| i | |->| | 
1 6/20 | | 6/715 1 |{ 6/5 
= { * | 
ee eR OR NUE ReENe Re em emt eee { 
DATECHECKX 
{PROG1.FTN| |PROG1.O0BJ] | 
| {->| [->] | 
| 6/20 i | 6/20 a | 
ereeewnn= 2 ew wenn n-- JALLPROG.TSK|-> TASK 
| * | | {| EXECUTION 
7 = G a a oe aaa awa 2a en @ ae | { 
JPROG2.CBL}] |PROG2.OBJ}] | l 
| |->] [->] | 
| 6/20 } | 6/20 ; | 6/20 | 
a it * 
Ee eRe | eet ese 
COMPILE LINK 


6 EXEC Command Functions in the 


Multi-Module Environment 
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3-9-7 LINK Command 

The LINK command links the object module to yield the image 
module in language and multi-module environments. If no object 
module exists, the LINK command compiles the source module to 


yield the object module. The LINK command does not datecheck, 
load, nor execute a program. 


Language Format: 


voln: filename 
LINK 
user vyoln: current progran 


‘ 


Multi-Module Format: 


LINK 
Parameters: 
volns: is a 4- to 4-character alphanumeric name 
specifying the volume on which the source file 
resides. If this parameter is omitted, the 
default is the user volume. 
filename is a i- to 8e-character alphanumeric name 


specifying the files to be compiled and/or 
linked. If this parameter is omitted, the 
current program is the defaulte A filename is 
meaningful only in a language environment. 


Functional Details: 


When the LINK command is entered in a multi-module environment 
and no object module exists, all source file fds contained in the 
EDF are compiled. The resulting object modules are then linked. 
If a link error occurs, the link sequence aborts, and this 
message is displayed: 


** LINK ERRORS: EXECUTION ABORTED 
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If a LINK command is entered when no environment was set, this 
message is displayed: 


** NO ENVIRONMENT SPECIFIED 


If there is a compilation error, the process ends with a nonzero 
end of task code, the link procedure never starts, and the 
process is aborted. This message is then displayed: 


** COMPILE ERROR - LINK NOT EXECUTED 


The LINK command also links all of the standard Perkin-Elmer run 
time libraries specified by the language extension assigned when 
the source file was created. 


3.97.1 Link Sequences 


The user can specify a link sequence by building a link file that 
must have the extension .LNK. When the link sequence is 
specified, the system searches the default user volume for a file 
with the .~LNK extension with a filename matching the EDF name or 
the current program. When it is found, it is executed. 


Example: 


*RUILD JOB.LNK 

BPD -STASLISH: ASK 
RB>INCLUDE PROG1.0BJ 
BO>INCLUDE PROG2.OBJ 
BOLIBRARY FVRTL,COBOL.LIB 
B>BUILD PROG.TSK 

B>END 

BD>ENDE 


If the user-specified link file is not found, the system uses the 
default link sequence. There is a default link sequence for each 
language environment. Following is an example of a default 
FORTRAN link sequence: 


>ESTABLISH TASK 

D>INCLUDE current program 

>INCLUDE LIBRARY SYSV:FV7RTL.OB8J/S 
>OP ECFLOAT, FLOAT, WORK=3072 
>BUILD filename.TSK 

>END 
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The LINK command functions are shown in figures 3-7 and 3-8. 


SOURCE AND OS8JECT MODULES BEFORE LINK 


{PROG1.FTN| |PROG1.0BJ} 


| | | | 
| 6/20 | | 6/20 | 


|PROG1.FIN{ |PROG1.0BJ| |PROG1.TSK| 
| { | [->| | NO 
| 6/20 {| |{ 6/20 { | 6/20 | EXECUTION 


LINK 


SOURCE PROGRAM BEFORE LINK 


| PROG1.FIN | 


[PROG1.FTN| {PROG1.O0BJ|] |PROG1.TSK| 
| |->| [->| NO 
| 6/20 | | 6/z0 | | 6/20 | EXECUTION 


eee ee ee, eee Nee eo 


COMPILE LINK 


Figure 3-7 LINK Command Functions in the Language Environment 
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SOURCE AND OBJECT PROGRAMS BEFORE LINK 


->|PROG1.FIN| |PROG1.OBJ| 

| | 
6/20 | | 6/20 | 
ALLPROG. EDF 


-~>|PROG2.CBL| {PROG2.0BJ] 


| 
| 
| 
| 
| 
| 
| 
| 
| 


| 
| 1 | | 
| 6/20 {| | 6/20 $ 


{PROG1.FIN| |PROG2.0BJ| 


1 { 
| i | {->| { 
| 6/20 ! | 6/20 | | | 
ens enenenannenon i #@e@@8 @n2 ee @ i | . 
{| ALLPROG.TSK | NO 
wr erest en 0 wee ewnnee { | EXECUTION 
|PROG2.CBL{ |PROG2.OBJ| | 
| { => | 
| 6/20 t | 6/20 ; | 6/20 | 
| oe 
eer | 
LINK 
SOURCE MODULE BEFORE LINK 
{ |} |PROG1.FTH| 
| {-> | 
| | { 6/20 | 
[ALLPROGe EDF ---ee---- 
| { 
{ [| s2eese==s= 
| [->| PROG2.CBL| 
| ; | | 
| ! | 6/20 { 
SOURCE MODULE AFTER LINK 
{PROG1.FTN{ |JPROG1.080) | i 
| [->| | 
| 6/20 ; | 6720 i; | i 
eremenen= eee eneane | | 
| ALLPROG.TSK | NO 
eeeeee eee 0 eee ene | { EXECUTION 
{PROG2.CBL|] |PROG2.OBJ| | { 
| ; | [->| | 
| 6/20 ' | 6/20 ; | 6/20 | 
| f | . 
“COMPILE | “LINK 


Figure 3-8 LINK Command Functions in the Multi-Module 


Environment 
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3.9.8 LIST Command 
The LIST command lists the fds of all the multi-module 
environment programs that are contained in the current EDF. 
Format: 

Lio. 


Functional Details: 


The LIST command causes a listing to be sent to the list device 
Specified by a@SSYSPFT when lu assignments were made. When this 
command is entered, this message is displayed: 


** CURRENT ENVIRONMENT = current EDF 


If the LIST command is entered and ne fds are in the multi-module 
environment, the following ressage is displayed: 


** ENVIRONMENT EMPTY 


If an argument is specified with the LIST command, this message 
is displayed: 


** TOO MANY ARGUMENTS 
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| REMOVE | 


3.9.9 REMOVE Command 
The REMOVE command deletes specified source fds from the current 
multi-module environment. 
Format: 
REMOVE £d 


Parameters: 


fd is a file descriptor of a source file 
contained in the EDF. 


Functional Details: 


When the REMOVE command is entered, the current EDF is searched 
for the specified fd. when found, the fd is removed from the 
multi-module environment. If the fd is not found, the following 
message is displayed: 


we FILENAME NOT IN ENVIRONMENT 


If the fd is omitted or is in an incorrect format, this message 
is displayed: 


** SYNTAX ERROR 


When all of the fds have heen removed from the multi-module 
environment, this message is displayed: 


we ENVIRONMENT EMPTY 
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3.9.10 RUN Command 


The RUN command loads and runs the image program in language and 
multi-module environments. This command does not datecheck, 
compile, or link. 


Formats: 


§ voln: : filename 
RUN 


[,-"start parameters"] 


user voln: current program 


Parameters: 


voln: is a - to 4echaracter alphanumeric name 
specifving the volume on which the image 
module resides. If this parameter is omitted, 
the default is the user volume. 


filename is a im to &-character name specifying the 
image mcdule.e If this parameter is omitted, 
the default is the current porogran. 


“start are Darameters particular to the assembler 
parameters” or comfbEllier being used. These parameters, 
usually specified with the operator START 


command, now can be specified with the program 
Ccevelopment RUN command. 


Functional Details: 


If a filename is not entered with the RUN command and a task with 
the filename of the current program does not exist in the 
language environment, this message is displayed: 


w© td NONEXISTENT 


See Section 3.9.6 for more information on Start parameters. 
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Figures 3-9 and 3-10 illustrate the RUN command functions. 


IMAGE MODULE BEFORE RUN 


|PROG1.TSK | 


| 6/20 | 


{PROG1.TSK| 

| |-> TASK 

1 6/20 {| EXECUTION 
RUN 


Figure 3-9 RUN Command Function in the Language Environment 


IMAGE MODULE BEFORE RUN 


| | 

| 

| 

[-> TASK 
{|ALLPPOG.TSK| EXECUTION 
| 

| | 

| | 

| | 


Figure 3-10 RUN Command Function in the Multi-Module Environment 
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Table 3-4 explains the functions of the commanis used to compile, 
link, and run a program. 


TABLE 3-4 


PROGRAM DEVELOPMENT COMMANDS THAT COMPILE, 
LINK, AND EXECUTE 


Compiles source module into object 
module when object module does not 
exist or is outdated. 


Datechecks source, object, and image 

modules, and compiles and/or links 

them if outdated to form image 
programe 


Compiles source module into object 
module when object module does not 
exist. Then links object module and 
standard run time libraries to form 
image program. 


Natechecks image, object, and source 
modules. Compiles and links them if 
outdated. Loads and runs up-to-date 
image frograme 


Loads and runs image program without 
datechecking, compiling, or linking. 


3-10 SAMPLE PROGRAM DEVELOPMENT SESSIOKS 


Thie¢ section presents coding examples using the 
development commands. 


“PORT LEST 
** NEW FROGRAM 
SEDIT 


(edit session) 
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Create language 
environment with the 
FORTRAN language command. 


Specify TEST as filename 
to be allocated. FORT com- 


mand loads and starts editor 


with TEST.FTN as current 
program. 


program 


SGLOBAL ASSYSIN,@SSYSOUT,9SSYSLIST 
*SSEL @SSYSINSCON: 

*SSET aSSYLOUT=CON: 

*SSET ASSYSLIST=PPF: 

ZERGC Leo. 

“FORTRAN: T®ST 


** COMPILE ERRORS, LISTING ON PR: 


TEDL. 
“FDL. = 


TESS 


(edit session) 


SAVE* 
PEND 


® EXEC 
(compilation sequence) 


e 


=FORTRAN = TEST 
“END OF TASK CODF=0 
SLI NK = TEST 


e 


(link sequence) 


~END OF TASK CODE=0 
ae BADGULLON, OF TEST -POLLOMS< 


e 
(execution sequence) 


“END OF TASK CODE=0 


TERSC 
we EXECUTICN OF TEST FOLLOWS: 


@ 

(execution sequence) 
9 
2 


*RUN 


“END OF TASK CODE = 0 


** EXECUTION OF TEST FOLLOWS: 


Define and set global variables. 


Execute TEST.FIN. 
Compile TEST.FTN. 
Compilation errors in TEST. 


Find and correct errors. 


Execute current program. 


Compile. 


Sucessful compilation. 
Linkedit. 


Successful link. 
Run. 


Successful execution. Pe-execute. 
Ensure program is compiled 
and linked. 


Compile, link unnecessary. Object 
and imazge up-to-date. 
Successful execution. 
Rerun, compile, or link. 
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(execution sequence) 


~END OF TASK CCDE=0 


*EXEC NEWPROG 
** FILE NEWPROG.FTIN NOT FOUND 


*MACRO 


*EXEC NEWPROG 
-MACRO - NEWPROG 
~CAL - NEWPROG 
“LINK - NEWPROG 


(link sequence) 


** EXECUTICN CF NEWPRCG FOLLOWS: 


(execution sequence) 


-~END OF TAS¥ CODE=0 


SELL 


(edit session) 


SAVE* 
D>END 


*EXEC 

-KACRO - NEWPPROG 
-CAL - NEWPPOG 
-LINK - NEWPROG 


(link sequence) 


** EXECUTION OF NEWPROG FOLLORS: 


e 


(execution sequence ) 


“END OF TASK CODE=0 
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Execute NEWPROG. 

System finds NEWPROG.MAC. Cannot 
find NEWPROG.FIN. Specify MACRO 
command to access NEWPROG.MAC. 


execute NEWPROG.MAC 
Expand. 

Assemble. 

Linkedit. 


Successful execution. 


edit current progran. 


Execute current proaqram. 
Expand. 

Assemble. 

Linkedit. 


Successful execution. 


Create multi-module environ- 
ment with ENV command. 


*ENV BIGTASK 

we NEW ENVIRONMENT 
*ADD SUB.CAL 

*ADD MACRTY.CAL 
*ADD FTOR.FTN 

* LIS? 

w* CURRENT ENVIRONMENT=BIGTASK.EDF 
“SUS.CAL 
-MACRTY.CAL 

~FTOR. FTN 

*ADD SUBFUNC.FIN 
*ADD YSUB.MAC 


®FREMOVE SUB.CAL 
*®FORT SUSFUNC 
-EDIT - SURTUNC 
(edit session) 


SAVE* 
>END 
PEDITISUS 


(edit session) 


° 


SAVE* 

> END 

*ENV BIGTASX 

*EXEC 

~FORTRAN = FTOR.FIN 
~FORTRAN =~ SUBFUNC.FTN 
-~MACRO = YSUB.MAC 

~CAL - MACRTY.CAL 
-~LINK - BIGTASK 


(link sequence) 
we BYECUTION OF BISTASK FOLLOWS: 


(execution sequence) 
@ 


“END OF TASK CODE=2 


* MAC 
*EDIT YSUB 


(edit session) 


BIGTASK.EDF allocated. 


Add 3 fds to EDF. 


List all programs in EDF. 


Add 2 more fds to EDF. 


Remove fd from EDF. 


Make changes to SUBFUNC.FTN. 


Make changes to YSUB.MAC. 


Create multi-module environment. 


Execute modules remembered in 
BIGTASK. 

FTOR.FTN and YSUB.object 
modules are outdated. 


Link BIGTASK. 


Execution errors traced to YSUB. 


Create language environment. 
Correct errors in YSUB.MAC. 
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SAVE* 


>END 

*ENV BIGTASK Create multi-module environment. 

* EXEC 

-~“MACRO:YSUB.MAC YSUB.MAC object is outdated. Expand, 


assemble, andi linkedit. 
-CAL - YSUB.MAC 
-LINK - BIGTASK 


(link sequence) 
** EXECUTION OF BIGTASK FOLLOWS: 


(execution sequence) 
e 


-~END OF TASK CODE=9 
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CHAPTER 4 
MULTI-TERMINAL MONITOR (MTM) BATCH PROCESSING 


4.1 INTRODUCTION 


In addition to interactive processing capabilities, MIM also 
supports concurrent batch processing, allowing the user to run 
multiple batch jobs from a single batch queue. This feature 
enables the user to effectively utilize the capabilities of the 
system with minimal interference to the interactive users. 


The number of concurrent batch jobs allowed at any time under MIM 
is set by the operator frem the system console. This number 
cannot exceed 64. If more batch jobs are submitted than there 
are active jobstreams, MTM queues the requests until a jobstream 
becomes available. 


The batch gueve is an indexed file containing the file descriptor 
(fd) of the jobs to be processed. Each job is identified in the 
queue by the fd of the command file. The batch queue is ordered 
in priority order and in first-in/first-out (FIFO) basis within 
a priority. 


Tasks executing in the batch environment run at a priority lower 
than or equal to the tasks in the terminal environment. Thus, a 
batch job executes when the system is not occupied with work from 
a terminal user. Satch jobs use the processor's idle time and 
therefore increase the efficiency of the system. 


G2 BATCH COMMANDS 


The batch job file consists of a series of MTM user commands 
and/or command substitution system (CSS) calls. The commands 
presented in this section are unique to the batch environment. 


To submit a batch job a user must have created a batch job file 
on disk. This file must have a SIGNON command as the first 
record, andi a SIGNOFF command as the last record. The only valid 
commands to be used between the SIGNON and SIGNOFF commands are 
MTM user commands (Chapter 2), program development commands 
(Chapter 3), batch processing conmmands, and calls toa CSS file 
(Chapter 5). R batch jeb file is not a CSS. Therefore, CSS 
commands, with the exception of SIFeee, SELSE, and SENDC, are 
invalid. Any command that can be used at a terminal can be used 
in the batch job file. 
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Example of a single batch job file: 


SIGNON 
L TEST 
ST 
SIGNOFF 


TEST1,1,PWD 
4 


Example CSS to build a batch job file and submit the job: 


** ASM. 


& * 
BU 
SIGNON 
XAL 
LOG 
ASM/G 
Site 
MESS 
SELSE 
MESS Le& 
=SENDC 
SIGNOFF 
SENDB 
SUs 
INQ 
SESE 


Css [MODULE] 
2 1 (MODULE TC BE ASSEMBLED) 
EXAMPLE: ASM EXIN 


a1.J0B 
a@1.-LO0G,IN,80 
a1.L0G,5 
@ 1 
0 
LEE *** 91.J0B COMPLETE *** 


Ee" @1.008. ERROR *** 


21.J0B,DEL 
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4U.2.-1 INQUIRE Command 
The INQUIRE command queries the status of a 


queuee 


Formats 


9 fd; 
INQUIRE [fd] 
user console 


Parameters: 


{ INQUIRE | 


job on the batch 


fd identifies the job for which the status is 


desired. ‘If fd is not 


specified, all jobs 


With account numbers the same as the user’‘s 


are displayed. 


fd1 specifies the file or device td which the 


display is output. If 


this parameter is 


omitted, the default is the user console. 


Functional Details: 
This command can be entered in command mode, 
and task executing mode. 


Possible responses to the INQUIRE command are: 


JOB fd NOT FOUND 
JOB fd EXECUTING 
JOB £d WAITING BEHINC=n 


NO JOBS WITH YOUR ACCOUNT 


task loaded mode, 


Examples: 
INQ All jobs with the user account 
number are displayed. 
INQUIRE TASK.JOB The status of TASK.JO08 is displayed. 
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4Ue2.-2 LOG Command 


The user can invoke a batch job to produce a log of its commands 


by 


including the 


batch stream. 


Formats: 


NOCOPY n 
soc | loose S| [tet 


SET LOG [fd] |, 


Parameters: 


fa 


COPY 


NOCOPY 


LOG command and the SCOPY command within the 


| " 
4 
EQPY. 45 


is the file descriptor of the log file or 
device. If no fd is specified, logging is 
terminated. If fd is a file, it must be 
previously allocated. Files are assigned EWO 
orivileges so that logged output is added to 
the end of the file. If a log is active when 
a second LOG command is entered, the old log 
is closed and the new one 1s initiated. 


specifies that all output is written to both 
the terminal and the log device. 


specifies that all output, except messages, is 
written to the log device and not the 
terminal. Messages from other users and the 
operator are written to both the terminal and 
the log device. 


is a decimal number from 0 through 65,535 
specifying the number of lines after which the 
log file is to be checkpointed. If this 
Parameter is omitted, the default is 15 lines. 
If n is specified as OQ, no checkpointing 
occurse 
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Functional Details: 


The LOG and the SET LOG commands are 
be entered either way, and both 
function. 

Checkpointing is only meaningful for 


Examples 


LOG PR: 
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4.223 PURGE Command 


The PURGE command purges a submitted job from the batch queue. 


Format: 


PURGE £4 


Parameter: 
rd is the file descriptor of the job to be 
purged. Only jobs with the user account 
number can be purged. 
Examples 
PURSE TASK.JO8 TASKeJOB is purged. 
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4.2.4 SIGNOFF Command 


The last command in a batch stream must be the SIGNOFF command. 


Functional Details: 


when a terminal user signs off the system, these messages are 
displayed: 


ELAPSED TIME=hhsmm:ss CPUTIME=utime/ostime 
SIGNON LEFT=hh:mme:ss CPU LEFT=hh: mmi:ss 
TIME OF Femm/dd/yy hh:mm:ss 


The SIGNOFF command can be entered in command mode, task loaded 
mode, and task executing mode. 
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4.225 SIGNON Command 


SIGNON must be the first command in a batch job. 


Format: 


fd 
SIGNON userid,actno,password  auesnonteer- 


[7.1 Ry 


Parameters: 


userid 


actno 


password 


ENVIRONMENT= 


NULL[: ] 


sCPUTIME=maxtime] . 


classid=iocount, [+ ++/classid=iocount 33] 


is a I= to 8-character alphanumeric string 
specifying terminal user identification. 


is a 3-digit decimal number from 1 through 250 
specifying the terminal user's account number. 
If this parameter is omitted, the password 
parameter should also be omitted. MIM will 
use the account number of the user submitting 
the batch job. 


is a 1= to i12-character alphanumeric string 
specifying the terminal user's password. This 
paraneter should be omitted if the actno 
Parameter is omitted. MTM will use the 
password of the user submitting the job. 


fd is the file descriptor specifying the file 
that will establish the uSer's environment at 
signon time. 


NULL specifies that the signon CSS procedure, 
USERINIT.CS5, should be ignored and the user 
will establish the environment at signon time. 
If the entire keyword parameter is omitted, 
MTM searches all online disks for the signon 
CSS procedure, USERINIT.CSS/P. The system 
volume, System account, is searched last. If 
USFRINIT.CSS is found, MTM calls the CSS and 
executes the routine. If it is not found, MTH 
enters command mode. 
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CPUTIME= maxtime is a decimal number specifying the 
maximum CPU time to which the batch job is 
limited. If this fFarameter is omitted, the 
default established at sysgen is used. If 0 
is specified, no limits are applied. The 
parameter can be specified as: 


mmmm:ss 
hhhh:mm:ss 
Sssss 


classid= is one of the W-character alphanumeric 
mnemonics, specified at sysgen, associated 
vith each specified device or file class. 


focount is a decimal number specifying the 
maximum number of I/0 transfers associated 
with a particular device class to which the 
batch job is limited. If this parameter is 
omitted, the default established at sysgen is 
used. If 0 is specified, no limits are 
applied to that class. 


Functional Details: 


Between the SIGNON and SIGNOFF commands, any command or CSS call 
that is valid from the terminal is allowed. A SIGNON command 
cannot be followed by another command, on the same line, 
separated by semicolons. When ENVIRONMENT=NULL is specified, the 
colon is optional. This allows the user the ability to specify 
the null device (NULL:). 

The account number and password can be omitted if a batch job is 
Submitted from a user terminal. If a batch job is submitted fron 


the system console or via the Spooler, the account number and 
password must be specified. 


Examples: 


SIGNON ME 

S ME,12,PSWD,CPUTIME=2:30:00,DEV1=150 
S ME,CPUTIME=120 

S ME,ENV=NULL,CPUTIME=120 


S ME,ENV=XYZ 
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4.2.6 SUBMIT Command 
The terminal user adds a job to the batch queue with the SUBMIT 
command. 


Format: 


SUBMIT fd [,DELETE] [,PRIORITY=priority] 


Parameters: 

re is the file descriptor of the file submitted 
to batch.e 

DELETE deletes the batch submit file the user created 
to submit a batch job. If this parameter is 
omitted, the batch submit file remains on the 
user volume. 

PRIORITY= priority is a decimal number from 10 through 


249 specifying the priority at which a batch 
job will run. If this parameter is omitted, 
a batch job will run at the default batcn 
priority (two priorities lower than the 
priority at which MTM runs) or the Link 
priority (the priority established when the 
task was built), whichever is lower. 


Functional Details: 


The priority at which a batch job runs is relative to the default 
priorities established at MTM sysgen. The u-task priorities are 
established at link time and can be reset with the PRIORITY 
parameter of the SUBMIT command. Interactive tasks run at one 
priority lower than MTM. Batch jobs run at two priorities lower 
than MTM. I the MIM sysgen priority is set to equal 1 (128), 
interactives jobs will run at priority +1 (129), or one lower than 
MTM;s batch jobs will run at priority +2 (139), two lower than 
MTM. 


The rules for establishing priorities are: 
® Ratch jobs can run at the same priority as interactive tasks 


but not higher than interactive tasks. 
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e If a valid priority is specified, the batch job runs at that 
criority or the link priority, whichever is lower. 


e If the specified priority is invalid, the default priority is 
assigned by MTM, and the following message is displayed: 


WARNING - REQUESTED PRIORITY n ILLEGAL, n USED 


® If no vu-task priority is specified with the SUBMIT command, 
the batch job runs at the default priority oor the link 
priority, whichever is lower. 


The SUBMIT command can be entered in command mode, task loaded 
mode, and task executing mode. 


Example: 


Create a batch job stream from the terminal via the BUILD..-ENDB 
sequence: 


BUILD TEST.JOB 
SIGNON ME,ENV=NULL 
LOG PR: 

Le TEST «1 sok 

AS 3,PR: 

START 

SIGNOF 

ENDB 


Submit the job from the terminal for batch processing: 
SUBMIT TEST.JOB 


Submit a batch submit file and have it deleted after the batch 
job execution is complete: 


SUBMIT XYZ.JOB, DELETE 


Submit a batch job and have it run at the same priority as an 
interactive job: 


SUBMIT XYZ.JOB, P=129 
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4.3 BATCH JOB SUBMISSION USING THE SPOOLER 


The Spooler is also used to submit batch jobs to the batch queue 
for execution under MT. Batch jobs submitted through the 
Spooler later can be resubmitted as a batch job through the 
terminal. 


4.4 ERROR HANDLING 


Any error that occurs in a batch job causes automatic termination 
of the job, and a mesSage is written to the log file or device. 
Tf a batch task pauses, the task is cancelled by MIM, and the end 
of task code is 255. The job will continue at the command 
following the START; i.e., the next task will be loaded. The 
task end of task code can be tested by subsequent commands in the 
batch stream to determine if the task completed normally. 


4.5 EFFECT OF RESTRICTED DISKS ON BATCH JOBS 


When accounts with access to restricted disks are given 
read/write access, batch jobs are not affected. If read-only or 
no access is specified, messages are not displayed on the user 
console. If a submit file for a batch job is on a restricted 
disk and account 0 does not have read/write access, the following 
message is displayed on the system console: 


eMTM: BATCH ASGN-ERR TYPE=PRIV JCB=fd 
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CHAPTER 5 
COMMAND SUBSTITUTION SYSTEM (CSS) 


5-1 GENERAL DESCRIPTION 


The command substitution system (CSS) is an extension to the 
OS/32 command language enabling the user to establish files of 
dynamically modifiable commands that can be called from the 
terminal or other CSS files and executed in a predefined 
sequencee In this way, complex operations can be carried out by 
the terminal user with only a few commands. CSS provides: 


e the ability to switch the command input stream to a file of 
device: 


® a set of logical operators to control the precise sequence of 
commands; 


@ parameters that can be passed to a CSS file so that general 
sequences can be written to take on specific meaning when the 
parameters are substituted: and 


e the ability for one CSS file to call another, in the manner of 
a subroutine, so complex command sequences can be developed. 


A CSS file is simply a sequential text file. It can be a deck of 
cards, a magnetic tape, or a disk file. An example of a simple 
CSS file is: 


WIHIS: 2S AN. EXAMPLE Of A. CSS FILE 
LOAD TEST.TSK/S,5 

ALLOCATE XXXDIX.DTA,CC, 40 

AS 1,INPUT.DTA 

AS 2,XXXDIX.DTA;AS 5, CON: 

ASSIGN 3,PRT:;*LU3-LINEFRINTER 
START 

SEXIT 
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5-2 CALLING A CSS FILE 


A CSS file is called and executed from the terminal by specifying 
the file descriptor (fd) cf the CSS file. Any valid fd can be 
used. If the leading characters of a CSS fd are the same as a 
command, MTM assumes a command: 


Example: 
CLO.CSS CLOSE MTM assumes the CLOSE command. 
AS3.CSS ASSIGN 3 MTM assumes the ASSIGN command. 


By specifying a volume name and/or extension, a CSS file that 
otherwise would conflict with an MTM command can be called. 


Examples: 

M300:CLOSE 

M300:CLOSE.CSS 
§.3 USE OF FARAMETERS 
The CSS filename can have parameters. The parameters are entered 
after the CSS fd and are separated from it by one character 
space. If there is more than one parameter, each is separated by 
commas. If a parameter contains the double quote character ("), 


all parameters up to the next double quote character are passed 
as one parameter. Null parameters ara permitted. 


Example: 


ABC P11, "P2A, P2B" calls CSS file AEC on the default volume with 


two parameters. Parameter 1 is Pi. Parameter 2 is P2A, P2B. 


JUMP ,,C calls CSS file JUME.CSS on the default volume with three 


parameters; the first two are null. 


Within a CSS file, a parameter is referenced by the use of the 
special symbol “adn" where n is a decimal integer number 
indicating which parameter the user is referencing. Parameters 
are numbered starting with 1. Parameter 90 has special meaning 
and is defined later in this section. The first parameter is 
referenced by a1, the second a2, etc. A straightforward text 


substitution is employed. 


cn 
t 
bo 
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Examples 


A CSS file ROG consists of: 


LOAD @ 1 
START 23,02 


It is called as follows: 


ROG PROGRAM, NOLIST, 148 


Before each line of the CSS file is decoded, it is preprocessed, 
and any reference to a parameter is substituted with the 
corresponding text. Thus, the file ROG with the previous call is 
executed as: 


LOAD PROGRAM 
START 148,NOLIST 


Example: 


Rll of the following references to parameter 12 are valid 
expressions: 


212 or @1i2ABC or 012.EXT 


Thies mechanism allows concatenation. For instance, if the first 
command in file ROG were LOAD @21.TSK, only those files with the 


extension .eTSK would be presented to the loader. Concatenation 
of numbers requires care. 12301 references parameter 1, but 
a1123 isa reference to parameter 1123. A reference to a 


nonexistent parameter is null. 


The multiple @ facility enables a CSS file to access parameters 
of higher level files. CSS files can call each other to a 
maximun depth specified at sysgen time. Thus, a@a2 in a CSS file 
refers to the second parameter of the calling file. 
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Example: 


Given the CSS call: 


CSS1 argi,arg2 


and assuming that in file CSS1 there is another call: 


CSS2 arg3,arg4 


the following references can be made in CSS2: 


a1 = arg3 
a2 = arg¥ 
agai = arg 
@a2 = arg2 


Tf a multiple d sequence is such that the calling level referred 
to is nonexistent, the parameter is null. 


Parameter a0 is a special parameter used to reference the name of 
the CSS file in which it is contained. Parameter @20 is replaced 
during the preprocessing cf the command line with precisely the 
same fd used to call the file. 


Examples: 


A CSS file consists of: 


AS 1,00 
SEXIT 


If this file is called from the card reader (CR:), then lu 1 is 
assigned to the card reader (CR:). Likewise, a call from the 
magnetic tape (MAG1;:) results in: 


AS 1,MAG1: 
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5.4 USE OF VARIABLES 

MTM and batch users can allocate a specified number of pseudo 
device variables to be used within a CSS. The maximum number of 
variables that can be defined is established at sysgen time. See 
the OS/32 Multi-Terminal Monitor (MTM) System Planning and 
Operator Reference Manual. 


5.4.1 Types of Variables 


There are two types of pseudo device variables: 


e Gliobai variables 

e Local variables 

Global variables exist from signon to signoff or until they are 
freed via the SFREE command. Local variables can be used only 
within the CSS levels in which they are defined. When a 
particular CSS level is exited, all local variables defined 
within it are freed. 

5.4.2 Naming Variables 

A variable name can consist of one through eight characters and 
is preceded by the commercial a2 sign. The character following 


the @ sign must be alphabetic; the remaining characters can be 
alphanumeric. 


Examples: 


ah 
aBi19 


@ABC123 


§.4.3 Defining Variables 


All variables must be defined by name using the SGLOBAL and 
SLOCAL commands. To set a variable to a specific value, use the 
SSET command. 
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5.4.4 Reserved Variables 


Variable names starting with the character string a@SYS are 
reserved for system use. A user cannot define variables starting 
with aSYSs. However, a user does have read and write access to 
aSYS variables. 


The global variable a@SYSCODE is reserved and contains the value 
of the last end of task code for a particular session. 


5-5 COMMANDS EXECUTABLE WITHIN A CSS FILE 


All of the MIM supported commands can be used ina CSS file, as 
well as a number of commands specifically associated with the CSS 
facility. 


All of the CSS commands start with the S$ character except for the 
SET CODE command. The S$ indicates where a CSS was used. 


The CSS commands entered within a CSS file are described in the 
following sections. Refer to Appendix E for CSS message 
descriptions. 


NOTE 


If a task is started when CSS is running, 
CSS becomes dormant until the task is 
terminated. Execution of the CSS strean 
will resume after the task terminates. 


226 48-043 FOO R00 


{ SBUILD and {| 
| SENDB | 


5.5.-% SBUILD and SENDB Commands 


The SBUILD command causes succeeding lines to be copied to a 
Specified file up to, but excluding, the corresponding SENDB 
command. Before each line is copied, parameter substitution is 
performed. 


Formats 


fd 
e270) [APPEND] 
lu 


SENDB 
Parameters: 


td is the output file. If fd does not exist, an 
indexed file is allocated with a logical 
record length equal to the command buffer 
length. If the fd specified does not contain 
an extension, .eCSS is the default. If a blank 
extension is desired, the period following the 
filename must be specified. 


lu specifies that a temporary file is to be 
created and the SBUILD data is copied to it. 
When SENDB is encountered, the file is 
assigned to the specified logical unit of the 
loaded task. 


APPEND allows the user to add data to an existing fi. 
If the fd does not exist, it is allocated. 


Functional Details: 


The SBUILD command must be the last command on its input line. 
Any further information on the line is treated as a comment and 
is not copied to the file. 


The SENDB command must be the first command in the command line, 
but it need not Start in column 1. Other commands can follow 
SENDB on the command line, but nesting of SBUILD and SENDB is not 
permitted. 
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5-5-2 SCLEAR Command 
The SCLEAR command terminates a CSS stream, closes all CSS files, 
and deactivates CSS. 
Format: 
SCLEAR 


Functional Details: 


The SCLEAR command can be entered in command mode, task loaded 
mode, and task executing mode. 
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5.5.3 SCONTINUE Command 


The SCONTINUE command resumes execution 
suspended by a SPAUSE or SWAIT command. 


Formats: 


Sy TINUE 


1a 
IO 
I= 
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525-4 SCOPY and SNOCOPY Commands 


The SCOPY and SNOCOPY commands control the listing of CSS 
commands on the terminal or log device (if from batch). S$COPY 
initiates the listing and all subsequent commands are copied to 
the terminal before being executed. The SNOCOPY command 
deactivates the listing, but is itself listed. The SCOPY command 
is an aid in debugging CSS job streams. 


Format: 
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§.-5.5 SEXIT Command 


The SEXIT command terminates a CSS procedure. Control is 
returned to the calling CSS procedure or the terminal if the CSS 
procedure was called from the terminal. All commands on the 


lines after the SEXIT command are ignored. 


Format: 


SEXIT 
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§.5.6 SFREE Command 


The SFREE command frees one or more pseudo variables. 
Format: 


SFREE varname, [,...,varnameg] 


Parameters: 
varname is a 1- to 8-character name specifying the 
variable whose name and value are to be freed. 
Examples 
SFREE aA 
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5.5.7 SGLOBAL Command 
The SGLOBAL command names a global 


command. 


Format: 


variable 


and specifies 
maximum length of the variable to which it can be set by the SSET 


the 


length length 
SGLOBAL varname peoe sVarname 
| 8 
Parameters: 
varname is a  - to 8-character name (the first 
character is alpabetic) preceded by the a 
sign, identifying a global variable. 
length is a decimal number from 4 through 32 
specifying the length of the variable defined 
by the SSET command. lf this parameter is 
‘omitted, the default is 8. 
Example: 


SGLOBAL aA(6) 
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S$JOB and STERMJOB Conumands 


The SJCB and STERMJOB commaads set the boundaries of a CSS job. 


The 


SJOB command 


indicates the start, and the STERMJOB command 


indicates the end of a CSS job that contains all the user CSS 


commands and tasxs. 


Format: 


$JOB 


[CPUTIME=maxtine] 


(,classid=iocountq[... ,classid=iocount32] 


SIERMJOB 


Para 


meters: 


CPUTIME= 


classid= 


mMaxtine is a decimal number specifying the 
maximum CPU time to which the CSS routine is 
limited. If this parameter is omitted, the 
default established at MTM sysgen is used. If 
© is specified, no limits are applied. 


is one of the Y-character alphanumeric 
mnemonics specified at MIM sysgen that is 
associated with each specified device or file 
class. 


jocount is a decimal number specifying the 
maximum CPU time to which the CSS routine is 
limited. If this parameter iS omitted, the 
default established at sysgen time is used. 
If 9 is specified, no limits are applied to 
that classe 
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Functional Details: 


The SJOB and STERMJOB commands are not necessary in a CSS 
procedure. However, they help prevent errors in one CSS job from 
affecting other CSS jobs. If a CSS job contains an error, the 
statements remaining in that job are skipped until a STERMJOB 
command is found. The next command executed is the first command 
found after a STERMJOB command. If the next command is a SJOB 
command signifying the start of a new CSS job, it could be 
skipped because the system is looking for a STERMJOS that 
Signifies the end of the CSS job containing the error. 


The CSS job containing an error is aborted, and the end of task 
code is 255. The S$JOB command resets the end of task code to 9 
for the next CSS job. 


Interactive jobs have no default limits established at sysgen 
time. However, the user can specify CPU time and I/90 transfer 
limits for a particular job through the $JOB command. 


Any limits in the SJO0B command found in a batch stream are 
ignored if Limits were already specified in the SIGNON command. 
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9 SLOCAL Command 


The SLOCAL command names a local variable and specifies the 


maxi 


mum length 


command. 


Forn 


Para 


Exam 


variable to which it can be set by tha SSET 


at: 
length length 
SLOCAL varnane | geoesVarnane : 
E 8 

meters: 

Varname is a  1- to S8-character name (the first 
character is alphabetic) preceded by the a 
Sign, identifying a local variable. 

length is a decimal number from 4 through 32 
specifying the length of the variable defined 
by the SSET command. If this parameter is 
omitted, the default is 8. 

ples 


SLOCAL @dAC4) 
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5-5-10 SPAUSE Command 


The SPAUSE command suspends execution of a CSS procedure. 


Format: 


SPAUSE 


Functional Details: 


When SPAUSE is entered, the CSS procedure remains suspended until 
the SCONTINUE command is entered or the SCLEAR command is entered 
to terminate a procedure suspended by a SPAUSE. 
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5.5.11 SSET Command 
The SSET command establishes the value of a named pseudo device 
variable. 
Format: 
SSET varname=e 


Parameter: 


varnane= e is an expression, variable, Or parameter 
established as the value of the variable. 


Functional Details: 


Expressions for this command are concatenations of variables, 
parameters, and character strings. No operators are allowed in 
an expression. If a character string is includad in an 
expression, it must be enclosed between apostrophes ('). If an 
apostrophe is part of the character string, it must be 
represented as two apostrophes (‘'°). 

The initial value of the variable is blanks. This allows the 


SIFNULL and SIFNNULL ccmmands to test for a null or not null 
value. 


Examples: 


SSET dA = DAIAA2 
SSET JA = OA1".MAC* 
SSET dA = 91 


SSET dA = ‘A**BS 


3=18 48-043 FOO ROO 


5.5.12 SET CODE Command 
The SET CODE command modifies the end of task code of the 
currently selected CSS task. 
Format: 
SET CODE n 


Parameter: 


n is a decimal number from 1 through 254. 
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525.13 SSKIP Command 


The SSKIP command is used between the $J08 and STERMJOB commands. 
The SSKIP command indicates that subsequent commands are to be 
skipped until a STERMJOB command is found. The end of task code 
is set to 255. 


Format: 


SSKIP 
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5.5.14 SWAIT Command 


The SWAIT command suspends execution of a CSS for ae specified 
period of time. 


Format: 
n 
SWAIT 
4 
Parameter: 
n is a decimal number from 1 through 300 
specifying the number of seconds CSS execution 
will be suspended. If this parameter is 


Omitted, the default is 1 second. 
Functional Details: 
The SWAIT command will only function from a CSS routine. 


When the SWAIT command is entered and the user does not want to 
wait the specified time, a SCONTINUE command can be entered. 
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5.5215 SWRITE Command 
The SWRITE command writes a message to the terminal or log device 
for both interactive and batch jobs. 
Formats: — 
SWRITE text [;] 


Functional Details: 


The message is output to the terminal or log device. It begins 
with the first nonblank character after SWRITE and ends with a 
semicolon or carriage return. The semicolon is not printed. 


5-6 LOGICAL IF COMMANDS 


The logical IF commands all start with the three characters, SIF, 
and allow one argument; e.g., SIFE 225, SIFX B.CSS, SIFNULL a1. 


Each logical IF command establishes a condition that is tested by 
the CSS processor. IF the result of this test is true, commands 
up to a corresponding SELSE or SENDC command are executed. If 
the result is false, these same commands are skipped. 


The SENDC command delimits the range of a logical IF; however, 
nesting is permitted so each SIF must have a corresponding SENDC. 
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In the following examples, the ranges of the various logical IF 
commands are indicated by brackets: 


SIF SIF 
SIF SIF 
ENDC ENDC 
° SIF 
SENDC y 
SENDC 
SENDC 


There is no restriction on the depth of nesting. Logical IF 


commands are 


used within a CSS filee However, they differ from 


previous CSS commands in that each one tests a specific built-in, 
defined condition rather than causes a specific action. 


The logical IF commands fall into three categories; 


e End of task code testing 


e® File existence testing 


@ Parameter existence testing 


5.6-1 End of Task Code Testing Commands 


The end of task code is a halfword quantity maintained for each 
user by the system. It is set or reset in any of the following 


Ways: 


SET CODE n 


SJO8B 
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This command, which can be included in a CSS 
file or entered at the terminal, sets the end 
of task code to n. 


As part of its start job function, this 
command resets the end of task code for the 
current CSS task to 0. 


Command error A command error causes the CSS mechanism to 
skip to STERMJOB assuming that a SJOB was 
executed. (If no $JOB was executed, CSS 
terminates.) To indicate that the skip took 
place, the end of task code is set to 255. 


SSKIPF This command has the same effect as a command 
error. 


EOT (SVC 3,n) When any task terminates by executing the end 
of task program command (SVC 3,n), the end of 
task cede for that task is set to n. 

CANCEL When a task is cancelled, the end of task code 
is set to 255.6 


The six commands available for testing the end of task code of 
the currently selected CSS task are as follows: 


— ye ye 


SIFE on Test end of task code equal to n 

SIFNE n Test end of task code not equal to n 
SIFL an Test end of task code less than n 

SIFNL oa Test end of task code not less than a 
SIFSG an Test end of task code greater than on 
SIFNG a Test end of task code not greater than on 


In all cases, if the results of the test are “false", CSS skips 
commands until the corresronding SELSE or SENDC. If a Css 
attempts to skip beyond FOF, a command error is generated. 


5-6-2 File Existence Testing Commands 


There are two commands dealing with file existence: 


SIFX f4 Test fd for existence 
SITFNX £4 Test fd for nonexistence 
If the result of the test is false, CSS skips to the 


corresponding SELSE or SENEC command. If a CSS attempts to skip 
beyond EOF, an error is generated. 


mn 
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5.6.3 Parameter Existence Testing Commands 


There are two commands dealing with the existence of parameters: 


SITFNULL an Test an null 

SIFNNULL on Test an not null 
If the result of the test is false, CSS skips to the 
corresponding SELSE or SENDC commande If such Skipping attempts 
to skip beyond EOF, a command error is given. 
The use of the multiple @ notation to test for the existence of 


higher level parameters is permitted. In addition, a combination 
of parameters can be tested simultaneously. 


Examples 
SIFN @4@ 2a 3 


In effect, this tests the logical OR of a1, @2, and @3 for 
nullity. If any of the three is present, the test result is 
false. 
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§.6.4% SELSE Command 


The SELSE command is used between the SIF and SENDC command to 
test the opposite condition of that tested by SIF. Thus, iff the 
condition tested by SIF is true, SELSE causes commands to be 
skipped up to the corresponding SENDC. If the condition is 
false, SELSE terminates skirping and causes command execution to 
resume. 


Format: 


SELSE 
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| SGOTO and f 
SLABEL | 


5.7 S$GOTO AND SLABEL COMMANDS 


The SGOTO command is used to skip forward within a CSS procedure. 
The SLABEL is used to define the object of a $GOTO. 


Format: 


SGOTO label 


SLABEL label 


Parameters: 


Label is from one to eight alphanumeric characters, 
the first of which must be alphabetic. 


Functional Details: 


The SGOTO command causes all subSequent commands to be ignored 
until a SLABEL command with the same label as the SGOTO command 
is encountered. At that point, command execution resumes. 


The S$GOTO cannot branch into a logical IF command range but can 
branch cut from one. 


An example of an illegal S$GOTO is: 


SIF Condition 
$GOTO OUTIF 
SENDC 

SIF Condition 


SLABEL OUTIF 


The SLABEL occurs within an IF block (the second IF condition) 
that was not active when SGOTO was executed. 
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The following is valid, 


22 


SIF 
SGOTO 


Condition 
OUTIF 


Condition 


OUTIF 


however: 


48-043 FOO ROO 


| SIFEXTENSION | 


5-8 SIFEXTENSION COMMAND 


The SIFEXTENSION command is used to test for the existence of an 
extension for a given fd. If the extension exists, subsequent 
commands are executed up to the next SELSE or SENDC command. lia 
an extension does not exist, subsequent commands are skipped up 
to the next SELSE or SENDC command. 


Formats: 


SIFEXTENSION fd 


Parameters 


fa is the file descriptor to be tested to 
determine if an extension is included. 


Functional Details: 


SIFEX (with no fd) is always considered false. 
SIFNEX (with no fd) is always considered true. 
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| SIFVOLUME | 


5e¢9 SIFVOLUME COMMAND 


The SIFVOLUME command tests for the existence of a volume name in 
an f£d. If a volume exists, subsequent commands are executed up 
to the next SELSE or SENDC command. If the volume is omitted in 
the £d, subsequent commands are skipped up to the next SELSE or 
SENDC command. 


Format: 
SIFVOLUME fd 
Parameter: 


fd is the file descriptor tested to determine if 
a volume name is included. 


5-10 LOGICAL IF COMMANDS COMPARING TWO ARGUMENTS 


The following logical IF commands are used t0 compare two 


arguments. They differ from the other logical IF commands in 
that they do not test specific built-in conditions but, rather, 
test conditions provided by the user. These commands are 


available only with MTM. 


SIF 2. -« »« EQUAL 
SIF « « « NEQUAL 
SIF . « »« GREATER 
SIF « »« « NGREATER 
SIF .« »« »« LESS 

SIF « « e NLESS 


For each of the logical commands, two arguments are compared 
according to the mode. There are three valid modes: 


e Character 
@ Decimal 


@ Hexadecimal 
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For character mode, the comparison is left-to-right and is 
terminated on the first pair of characters that are not the same. 
If one string is exhausted before the other, the short string is 
less than the long string. If both strings are exhausted at the 
Same time, they are equal. For character mode, the arguments can 
be enclosed in double quotes if they contain blanks. The quotes 
are not included in the compare. 


For decimal and hexadecimal mode, the comparison is performed by 
comparing the binary value of the numbers. 


If after comparing the arguments for each of the commands, the 
condition is determined to be true, subsequent commands are 
executed up to the corresponding SELSE and SENDC. If the 
condition is false, commands are skipped up to the corresponding 
SELSE or SENDC. 
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5.10.1 SIF eee EQUAL, SIFeee NEQUAL Conmands 


The SIF..e-EQUAL command is used to determine if two arguments are 
equal, while the SIF..e-NEQUAL is used to determine if two 
arguments are not equal. 


Format: 
CHARACTER 
SIF DECIMAL arg: EQUAL arg> 
HEXADECIMAL 
CHARACTER 
SIF DECIMAL arg; NEQUAL arg, 
HEXADECIMAL 


§.10.2 SIF..eeGREATER, SIF. eNGREATER Commands 


The SIF..e.-GREATER command is used to determine if argi is greater 
than arg2. The SIF..eNGREATER command is used to determine if 
arg? is not greater than arg2. 


Format: 
CHARACTER 
SIF DECIMAL arg, GREATER argo 
HEXADECIMAL 
CHARACTER 
SIF DECIMAL arg; NGREATER arg> 
HEXADECIMAL 
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5.10.3 SIF..eLESS, SIF.eee-NUESS Commands 


The SIF.-e-LESS command is used to determine if arg1 is less than 
argZe The SIF..ee-NLESS command is used to determine if arg1 is 


not less than arg2. 


Formats 


CHARACTER 
SIF DECIMAL arg4 LESS arg, 


HEXADECIMAL 


CHARACTER 
SIF DECIMAL arg, NLESS argo 


HEXADECIMAL 
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CHAPTER 6 
SPOOLING 


6¢1 INTRODUCTION 


The OS/32 package comes with a spooler task for both input and 
output spooling. At system generation (sysgen) time, the spool 
option must be included and the pseudo print devices declared in 
order to incorporate the spooling facility. 


6-2 INPUT SPOOLING 
The input spooling feature enables a batch stream of cards such 
as source programs, Operator commands, command substitution 
system (CSS) files, or other user data to be copied onto a disk 
file for immediate or subsequent processing. There are two 
control commands available for input spooling: 

/@INPUT 

/aSUBMIT 
In all cases, each deck of cards to he copied must end with a 
control card with the /a aprearing in columns 1 and 2. 
6-2-1 Input Card 
The /@INPUT card copies all the data between the /dINPUT and the 
/a cards to a disk file. The resulting file can be explicitly 
assigned and read by the user in order to ccess the spooled 
infcrmation. 
Cards to be copied must be preceded by a control card with the 


format: 


ZaINPUT fd/actno ,DELETE 
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Parameters: 


fd is the file descrirtor of the disk file in the 
form of voln:filename.eext. The only required 
field is filename. If voln is omitted, the 
default spool volume is used. 


actno is the account number the terminal user signs 
on with. 
DELETE specifies that if a file with the same name 


and account number already exists, that file 
is deleted and reallocated. 


CAUTION 


If THE WRONG ACCOUNT NUMBER IS ENTERED, 
THE USER MIGHT CELETE ANOTHER USER FILE. 


Example: 


A certain task (TEST.TSK) requires five input data records in 
order to execute. The following statements place these five 
input statements ona disk file named TEST.DTA (associated with 
account number 12) and delete and reallocate TEST.DTA if it 
already exists: 


/DIN TEST.DTA/12,D 
4 INPUT TEST 
122736 

645627 

889710 

632192 

/@ 


6e2e2 Submit Card - Adding Batch Jobs to the Batch Queue 

The Spooler can also be used to submit batch jobs to the 
multi~terminal monitor (MTM). This is done through the /aSUBMIT 
command which copies card files to the disk and submits the file 
as a batch job. The commands are executed in sequence. The file 


remains on the disk after execution. 


To add batch jobs te the batch queue via the Spooler, submit a 
control card with the format: 


Format: 


LaSUBMIT fd/actno ,LELETE 
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Parameters: 


fd is the name of the command file; i.ee, the 
batch jeb, that is to be placed on the batch 
queue. 

actno is the account number the terminal user signs 
on with. 

DELETE specifies that if a file with the same name 


and account number exists, that file is to be 
deleted and reallocated. 


Each deck of cards must end with a control card with /ad appearing 
on columns 1 and 2. 


Refer to the OS/32 System Support Utilities Reference Manual for 
more information on the Spooler. 


There are two ways to submit a batch job using the Spooler. 
Method 17: 


First a CSS file is copied from a card file to a disk file named 
TEST.CSS (associated with account number 12) on the default spool 
volume. If TES ce CSS already exists, it is deleted and 
reallocated. This is done as follows: 


/@INPUT TEST.CSS/12,D 
LO TEST 

AS 1,TEST.DTA 

AS 3,PR: 

AS 5,MAGi4: 

START 

/a 


The CSS file TEST.CSS now can be executed by the batch Job 
TEST.JOB. If a file already exists on the disk with the name 
TEST.JOB, it is deleted and reallocated. When running concurrent 
batch jobs, each signon ID must be unique. Submit this job as 
follows: 


/O@SUBMIT TEST.JOB/12,0 
SIGNON ME,12,PASSWD 
LOs PR: 

TEST <CSS 

SIGNOFF 

/a 
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Method 2: 


Cnly one step is required to build the file TEST.JOB and submit 
it as a batch job. The commands are executed in sequence. If 
the file TEST.JOB already exists on the disk, it is deleted and 
reallocated. After this batch job compietes, the file TEST.JOB 
remains on the disk: 


/@SUBMIT TEST.JOB/12,0D 
SIGNON ME,12, PASSWD 
LOG PR: 

LO Test 

AS 1,TEST.DTA 

AS 3,PR: 

AS 5,MAG1: 

START 

SIGNOFF 

/a 


6.3 OUTPUT SPOOLING 


Cutput spooling allows more than one task to be assignei to one 
or more print or punch devices simultaneously. Data to be 
printed or punched is written to disk files where it is then 
cocied by the Spooler to the available print or punch devices on 
a task priority basis. 


To make use of the output Spooler, assign any logical units (lu) 
to be orinted or punched to one or nore pseudo devices. As soon 
as the lu is closed, the Spooler automatically will print of 
punch the results. Printing or punching may be delayed because 
of a backlog to the device. 


There is no limit to the number of tasks or logical units that 
can be asSigned to a pseudo device. After the user makes an lu 
assignment, the following occurs internally: the operating 
system automatically intercepts all assignnaents to a pseudo 
device and allocates an indexed file called a spool file on the 
spool volume. Subsequent output calls cause data to be written 
to this file and not to the device. The Spooler supports both 
image and formatted writes. 


When the lu assigned to the spool file is clesed, the filename, 
task name, ard priority are placed into the Spooler print or 
punch queue. The queue is maintained as a file on the spool 
volume. If there is an entry on the queue, the output Spooler 
begins printing or punching and stays active as long as there is 
something on the quevee Files are spooled and output on a task 
pricrity basis. The user must ensure that sufficient disk space 
is available to accommodate output spooling. The user task is 
responsible for handling end of medium (EOM) status while writing 
to spool files within their own standard I/0 error recovery 
routines. 
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Printing multiple copies of a disk file or punching multiple 
copies of a card deck is accomplished through use of the Spooler. 
To print or punch a disk file using the Spooler, issue a command 
through MIM from the terminal. This is done with the PRINT and 
PUNCH commands. See Sections 2.36 and 2-37.- 


If the device specified in a PRINT or PUNCH command does not 
SUBPOrt printed output or output punching respectively, the 
output will be generated in the way that is supported on the 
specified device. 


For print files, a header page precedes each file printed. The 
header page has the format: 

USERID 

ACCOUNT NUMBER 

TIME OF DAY 

DATE 
when a file is directed to a card punch file, each output record 
is 80 bytes in length. A header card precedes the punched 


output; a trailer card terminates the punched output. Header 
suppression is not supplied. 


Example: 


To list and punch a file named TEST.CSS in account number 12 on 
the volume MIM using the Spooler, enter: 


SIGNON ME,12,MEPASS 
PRINT MIM: TEST.CSS 
PUNCH MIM: TEST.CSS 
SIGNOFF 


The header page for the print examples reads: 


TEST 

AC=00012 
14:36:50 
07/08/77 
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6-4 SPOOLING ERRORS 
The following message is generated by the operating system in 
response to a spooler command. 


FILE voln:filename.ext/acct NOT ENTERED ONTO PRINT QUEUE 


A spool file was closed but the spooler task was not loaded or 
started. The system operator can reenter a .SPL PRINT command 
when the Spooler is started. 
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APPENDIX 


A 


MTM COMMAND SUMMARY 


au 


key 
CONTIGUCUS,fsize : 
$60 


oof 
covet 


ALLOCATE fd, 


access privileges 


SRW 
ASSIGN lu,fdl, 
SRO 


PFILE fd, lu 


address 
LS 
BL . 


EREAK 


BRECORD [£d,] 1u 
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bsize 


4 


Ht 


keys 


80600 


He 


el ee tHE SH] Pccoe 


S¥C15 


| 


VEC 


ee a SE ee a ob 


fd 
puro | [APPEND] 
Llu 


ENDB 


CANCEL 


lu, — 


CLOSE 
ALL 


CONTINUE [address] 


DELETE fd, [-fd2,.0-,fda] 


fd 
DISPLAY ACCOUNTING |, 
user canscle 
fd 
DITELAY DEVICES |, 
user. conscocla 


fd 
DISPLAY DFLOAT |, 
user console 


DISPLAY FILES , voln: . [filenane] [+ ext] 
| 


defanit. user vol 


Ee 
Well Lf 
[ user console 


fd 
DLSPLAY FLOAT 7 
user cansole 


G@ 
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DISPLAY 


fd 
LU |, 
user console 


fd 


PARAMETERS |, 
user console 
fd 
REGISTERS |, 
user console 
fd 
TIME |, 
user console 


fd 
USERS |, 
user console 


MESSAGE 


DISPLAY 
DISPLAY 
DISPLAY 


DISPLAY 


PROMPT 
ENABLE 
ETM 


SVARIABLE 


an 


address,|</address> | 
user 


03 


EXAMINE 


FFILE [fa,J1u 


FRECORD [fd,] lu 


mnemonic 
HELP 
bg 
segsize increment 
INIT fdj, 
4 
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fd 


wvasote} 


eid; 
TNOQOUIRE |f4a 
user console ; 


LCAD [taskid,] fd [,segsize increment] 


Loc [£4] |, f et {et 


userid 
message 


MESSAGE 
.OPERATORS 


data, 


© 


AFPAUSE SYCPAUSE 
QPTIONS ; [/ NRESIDENT] 
AFCONTINUE SVCCONTINUE 


[-dataz,-e.,datan] 


MODIFY scdsess, || 


PREVENT 


PRINT fd [ DEVICE=pseudo device] [,coPrIeS=n}] [,DELETE] [,vFC] 


PUNCH f4 [,}DEVICE=pseudo device] [,copres=n}] [/DELETE] [PvFc] 
PURGE fd 


RENAME oldfd,newfd 


REPRCTECT fd,new keys . 
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REWIND [fd,] lu 
or 


PW (fd,Jlu 


act 


ADD, 


RYOLUME voln, 
REMOVE, 


USERS 


sent message [3] 


NOCOPY 
SET LOG [fd] |, 
COPY 


SIGNON userid,actno,pas 
eCPUTIME=maxtin 


pod assSid=iocoun 


address 
START 
transfer address 
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RW RW 
ho 4 / geee fe ACTNO 266 | 
EG RO 
RW 
ALL / 
RO 
RW RW 
actno, \ eeeer aACtNnO 566 \ : 
RC RO 


RW 
bu \ 
RO 


actno 
f actno; ~- actno2 


0-255 


a 


fd 
sword |, ENVIRON MENT= 
NULL [:] 
e 


t4 [- eee ,classid= Locount 33]| 


1 [parameter ;,-.-.,parametern] 


| [SUBMIT fd ,DELETE] [,PRIORITY=priority] 


| taskid 
| TASK 
| sBGROUND 


CONTIGUOUS, £size 


ao CT 


VOLUME [volin] 


WFILE [fd,] lu 


keys 
CONTIGUCUS,£size |, 
GOSS | 


lrecl bsize isize 
cot] IE 
XALLOCATE £4, | 428: % 3 
one 
H soo 
lrecl bsize keys 
conf] Fea Ae 
26 % G000 


XDELETE fd, [,fd2«++,/fdn] 
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APPENDIX B 
PROGRAM DEVELOPMENT COMMAND SUMMARY 


ADD fd [,essprod] 


voln: filename 
CO MPI L E * Sie sie? ters oe sac cera <o Cw Le pee Oi eMC el Se Lives Mele elee: elel. . Set acwleleie> ca 
ueer-vOins)| | (current “progres 


filename 


voln: 
COMPILE ALL 


et note 


RS I a oe IS oo De S00 
eee ovens 86 


eee | ee 


. 
a 


* * @ole ee o, *, 
atetensatvtaretet die’ Mer Nea tat © Setate ata? watetetatet TL Sted ote etetet fatate, eececesetesetetetece ye tats otf STred Celbteteteretatete 
a *, 58 by soe yy 8 baba Mew. yet be ete tere? falpee’ oe eas, Ce 
ae . . > ° Reno ey 
, » * + ee, « *, « 
2 Oa, * . - 4, . % Me overe * 
v . 
ste . ¢ ?, a * ee es ot « o *) 
canis ° —! PR NE OR SP : 
. ’ 2 ee. ‘ . wetter . ote" eeu oe 7 . *y 


voln: filename 
steer -veint)|| current pregrak 


voln: filename 
ENV 7” 
user voin: current proyranr. 


NULL 


COMPLINK - 


voln: filename “7 
LINK | 
user: woins )|| (current progrer 


LIST 


voln: filename 
Sat vot: curtest prtsran. 
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REMOVE fd 


. et 
+00! rayetete, 
ERO) 


ot at 2 
RS bth 
ry 

. 


voln: filenane 
RUN - ee [-"start parameters”]| 


re, 
eee a ae 
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APPENDIX C 
CSS COMMAND SUMMARY 


fd 
ser} [-APPEND] 
lu 


SENDB 
SCLEAR 
SCONTINUE 


SCOFY 


SNOCOPY 
ZELSE 
SENEC 
SEXIT 


SFPEE varname, [,...,varnameg] 


length length 
SGLOEBAL varname eecoesVarname 
g § 


SGOTO label 


SLABEL label 
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SIF DECIMAL 


CHARACTER 
arg i EQUAL atg9 


HEXADECIMAL 


eG 


HEXADECIMAL 


CHARACTER 


SIF DECIMAL arg, GREATER arg> 


HEXADECIMAL 


DECIMAL arg, NGREATER arg, 


CHARACTER 
DECIMAL arg; NEQUAL argo 


HEXADECIMAL 


CHARACTER 
SIF DECIMAL | arg1 LESS arg, 


HEXADECIMAL 


CHARACTER 


DECIMAL 


t=4 


arg, NLESS arg> 


! 
: 
: 
! 


SS 


HEXADECIMAL 


SIFEXTENSION fd 


SIEG n 
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SIFL n 


SIFNE n 


SIFNG n 


SIFNL non 


jn 


IFNULL an 


SIFNNULL an 


SLEVOLUME f4 


SIFX fd 
SIENX fd 
SJOE 


CPUTIME=maxtime 


[,classid=iocounti][,... ,classid=iocount 32] 


TERMJOB 
length length 
SLOCAL varname geoesVarname 
8 8 
SPAUSE 


SSET varname=e 


. SET CODE n 
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2) 


SWRITE text Le] 
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APPENDIX D 
MTM MESSAGE SUMMARY 


ACCESS PRIVILEGE ADDRESS ERROR AT XXXXXX 
MEMORY FAULT ADDRESS=XXXKXKXxX 


An attempt was made to access a valid segment in an invalid 
mode; LeG@e, store into a write protected segment; execute 
instructions from an execute protected segment; load from a 
read protected segment. 

ACCT-ERR 
The account number specified is not between 0 and 255. 

RLIGNMENT FAULT INSTRUCTICN AT XXXXXX 

MEMORY FAULT ADDRESS=XXXXXX 
Data instruction not preperly aligned to specific fields for 
fullword or halfword alignment. The memory fault address is 
the memory location that is not properly aligned. The memory 
fault address is given only on Perkin-Elmer 3200 Series 
Machines. 

ALLO-ERR TYPE=NAME 


R desired filename currently exists on the specifiei volume. 


The block size of an indexed file exceeds limit establisned 
at sysgen time. 


For an indexed file, a zero logical record length or data 
block size was specified. 


ALLO-ERR TYPE=TYPE 


The volume specified is not a direct access device. 


ALLC-ERR TYPE=VOL 


The volume name specified, or the name it defaulted to, is 
not the name of any cf the disks currently online. 
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ACCT=ERR 


The account number specified is not between 0 and 255. 


ARGS-ERR 


The amount of space between CTOP and UTOP is insufficient for 
placement of START ccmmand arguments by the command 
processor. 


ASITHMETIC FAULT AT XXXXXX 


A fixed or floating point error was detected at address 
XXXXX¥X, Or an attempt was made to divide by zero. This only 
cccurs on Perkin-Elmer Models 7/32 and 8/32 Machines. 


ASGN-ERR 


The assign failed for reason denoted by TYPE field. 


ASGN-ERR TYPE=BUFF 


An attempt was made to assign a file when there was 
insufficient system space available to accommodate the FCB. 


ASGNwERR TYPE=LU 


op | 


An attempt was made to assign to an lu that iS greater than 
the maximum lu number specified at Link time. 


ASGN-ERR TYPE=NAME 


An assignment is being directed to a nonexistent file. 


ASGN-ERR TYPESPRIV 


A file, currently assigned to an ilu with a given privilege, 
is assigned to another lus e@ege, an assignment of ERW is 
directed towards a file currently assigned for SRO. 


ASGN-ERR TYPE=PROT 


The file being assigned to is unconditionally protected (read 
and/or write keys=X*FF") or the read/write keys specified in 
the ASSIGN command do not correspond to those associated with 
the file, and tne file is conditionally protected (read 
and/or write keys not X'00' or X‘FF‘). 
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ASGN-ERR TYPE=SIZE 


An indexed file is being assigned and there is not enough 
room on the disk to allocate a physical block. 


ASGN-ERR TYPE=SPAC 


An assign is refused because the available task system space 
was exceeded. 


ASGN-ERR TYPE=TGD 


An attempt was made to assign a trap generating device. 


ASGN-ERR TYPE=VOL 


Volume name specified or defaulted to is not the name of any 
of the disks currently online. 


BTCH-ERR 


The batch capability was not started and is not available for 
a SUBMIT command. 


BUFF-ERR 


The expanded CSS line overflowed CSS buffer size. 


CLOS=ERR 


Close failed for reason denoted by TYPE field. 


DELE-ERR TYPE=ACCT 


An attempt was made to delete a file not on the user's 
private account. 


DEL“ERR TYPE=ASGN 


An attempt is being made to delete a file that is currently 
asSigned, or is being processed by the CSS processor. 


DELE“ERR TYPE=BUFF 


There is insufficient memory available in system space to 
perform a delete functicn. 
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DELE-ERR TYPE=DU 


An attempt was made to delete a file from a device that is 
not on line. 


DELE“ERR TYPE=IO 


An I/O error was encountered while attempting to delete a 
file. 


DELE-ERR TYPE=NAME 


File with a specified name was not found. 


DELE-ERR TYPE=PROT 


An attempt is being made to delete a file with nonzero 
protection keys. 


DELETERR TYPE=TYPE 


The volume name specified or defaulted to is not a direct 
access device. 


DELE-ERR TYPE=VOL 


Nonexistent file is assigned to a task. 


DUPLICATE USERNAME 


Userid is already in use. 


EDS Ere 


The file descriptor is syntactically incorrect or invalid, or 
a program on the disk is being loaded without enough system 
Space. 


fd IS NOT A CONTIGUOUS FILE 


The INIT command can only be used to initialize contiguous 
files. 
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FILE voln: filename. ext/acct NOT ENTERED ONTO PRINT QUEUE 


A spool file was closed but the spooler task was not loaded 


Or started. 


FIXED POINT-ZERO DIVIDE ERROR AT XXXXXX 
NEXT INSTRUCTION AT XXXXXXX 


An attempt was made to divide by zero. Current instruction 


aborted, and next instruction at address xxxxxx. 


FIXED POINT-OVERFLOW ERROR AT XXXXXX 
NEXT INSTRUCTION AT XXXXXX 


Fixed point arithmetic result is too large to be represented. 


Instruction aborts. Next instruction at xXxxxxXxe 


FLOATING POINT-UNDERFLOW ERROR AT XXXXXX 
NEXT INSTRUCTION AT XXXXXX 
Results of floating point operation are too small to 


represented. Instruction aborts. Next instruction 
XXXXXXe 


FLOATING POINT-OVERFLOW ERROR AT XXXXXX 
NEXT INSTRUCTION AT XXXXXX 
Floating point arithmetic procedure is too large to 


represented. Instruction aborts. Next instruction 
XXXXXXe 


FLOATING POINT-ZERO DIVIDE ERROR AT XXXXXX 
NEXT INSTRUCTION AT XXXXXX 


An attempt was made to perform a floating point divide 
Zero. 


FORM-ERR 


The command format is invalid. 
GOTO-ERR 


A SLABEL that is terninating the range of the S$GOTO 
branching into an IF group. 
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ILLEGAL INSTRUCTION AT XXXXXX 


The user task attempted to execute an illegal instruction at 
location XXXXXxX. 


ILLEGAL SVC-INSTRUCTION AT XXXXXX 
SVC FARAMETER BLOCK AT XXXXXX 


The user task attempted to execute an illegal SVC at location 
XXXXXX. 


INVALID SEGMENT ADDRESS ERROR AT XXXXXX 
MEMORY FAULT ADDRESS=XXXXXX 


An attempt was made to access a memory location not within a 
valid mapped segment; i.e., an attempt to access a memory 
location outside of the task space. 


INVALID ACCOUNT 


Invalid or unrecognized account number. 


INVALID PASSWORD 


Password is invalid. 


LJO ERR 


A device/file being accessed by MIM is returning a4 nonzero 
I/CG status. 


IT/O~ERR TYPE=DU 


The device is unavailable. 


IT/O-ERR TYPE=EOM I/O-ERR TYPE=EOF 


The device reached an EOQM or EOF before completing the 
Operation. 


I/O-ERR TYPE=FUNC 


An invalid operation is being directed toward a device; @6.g., 
attempting to write to a read-only device. 
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I/O-ERR TYPE=LU 


An illegal or unassigned lu. 


I/C-ERR TYPE=FRTY 


AR parity or other recoverable error occurred. 


I/O-ERR TYPE=UNRYV 


An unrecoverable error cccurred. 


JOSS@ERR 


A SJOB statement was encountered following another 
statement but prior to a STERMJOB statement. 


JOB NOT FOUND 


The fd of job to be purged is invalid. 


LOAD-ERR TYPE=ASGN 


Load could not be accomrlished because the specified fd 
already exclusively assigned. 


LOAD-ERR TYPE=DU 


Attempt was made to load from an unavailable device. 


LOAD-ERR TYPE=I/0 


An I/O error was generated during the load operation. 


LOAL-ERR TYPE=LIB 


The data in the loader information block is invalid. 


SJOB 


is 


This 


error most frequently occurs when an attempt is made to load 


a task which was not built with Link. 


LOAP-ERR TYPE=LOPT 


Task options are incompatible with the system environment 


that attempts to lead the task: i.e., attempt to load an 


e-task under MTM where e-task loading under MTM is 
enabled. 
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LOAUD-“ERR TYPE=MEM 


A load was attempted without a large enough segment. 


LOAD-ERR TYPE=MTCB 


The maximum number of tasks specified at sysgen time was 
exceeded. 


LOAD-ERR TYPE=NOFP 


A task requiring floating point support is being loaded, and 


the required floating point option is not supported in the 
system. 


LOAD-ERR TYPE=SEG 


A task requiring a task common area (TCOM) and/or a run time 
library (RTL) is being loaded. The TCOM/RTL is not in the 
system and cannot be loaded. 


LOAD-ERR TYPE=ROIO 


There is an I/O error on the roll volume. 


LOAD-ERR TYPE=RVOL 


There is a roll file allocation or assignment error. 


LUERR 


An lu specified in an assign statement is invalid. 


LVL@ERR 


The number of sysgen CSS levels was exceeded. 


MEMORY ERROR ON DATA FETCH AT XXXXXX 
MEMORY FAULT ADDRESS=XXXXXxX 


Attempt was made to retrieve or ta load data from a failing 
memory area on Perkin-Elmer 3200 machines. If affected 
memory is within task Space and the operating system has 
memory diagnostic suprort, the affected page is automatically 
marcked off, and this message is displayed: 


AFFECTED MEMORY PAGE MARKED OFF AT KXXXXX 
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MEMORY ERROR ON INSTRUCTION FETCH AT XXXXXX 
MEMCRY FAULT: ADDRESS=X.X 4X2 % 


kK Perkin-Elmer Model 3200 machine attempted to execute an 
installnent from an area of memory that is failing. If 
affected memory is within task space and th2 operating system 


has memory diagnostic support, the affected 7age is 
automatically marked cff, and this message is displayed: 


AFFECTED MEMORY PAGE MARKED OFF AT XXXKXX 


MEMORY PARITY FRROKR AT XXXXXX 


Fetempt made to access nonexistent or bad memory on Model 
7/32 and 8/32 machines. 


MISSING PASSWORD 


Fassword omitted. 


ee oe ea Oe ves 


The command mnemonic entered is unrecognizable. 


NOPE ERR 


Ko floating point support exists in the system. 


NON FXISTENT SFGMENT ERROR CFST) AT XXX¥XXX 
MERCRY FAULT ADDPESS=KXXKXX 


An attempt was made tec access a memory location greater than 


the maximum valid program address; 3.e., an attempt to access 
a memory location outside of tne task space. 


NOPR-ER? 


A command was entered that required more parameters than 
specified in the command line. 


FACKED FORMAT-SIGN ERROR AT XXXXXX 
MEMCRY FAULT ADDRESS=XXXXXX 


An iliegal sign digit was detected in a packed dacimal nunbder 
at xxxxxx for Perkin-Elmer 3200 Model machines only. 


WE-CU3 FOO KOS 


ho 
t 
\O 


niin tai Ci ea 


PACKED FORMAT=-DATA ERROR AT XXXXXX 
MEMCRY FAULT ADDRESS=XXKKXXX 


A data error was detected in a packed decimal number at 
Xxxxxxx for Perkin-Elmer Model 3200 machines only. 


PARM-ERR 


A command was entered with invalid or missing parameters. 


PELV=ERR 


The access privilege mnemonic is syntactically incorrect, or 
an MTM user without access privileges tried to access a 
restricted file. 


RENM-ERR TYPE=NAME 


A filename already exists in the volume directory. 


RENM“ERR TYPE=PRIV 


The file/device cannot be assigned for ERW (required to 
perform the rename) because the file/device is currently 
assigned to at least cne lu. 


The protection keys cf the file to te renamed are not 
X¥°Q000°. 

REPR-ERR TYPE=PRIV 
The file/device cannot Le assigned for ERW (required to carry 


out the reprotection) because the file/device is currently 
assigned to at least cne lu. 


ROLL@ERR 


The task is currently rolled out. 


SEGMENT LIMIT ADDRESS ERRCR AT XXXXXX 
MEMORY FAULT ADDRESS=XXXXXX 


An attempt was made tec access a memory location within a 
valid mapped segment, but the page number in the segment is 
greater than the largest valid page number for the segment; 
ie-@e, anh attempt to access a memory location outside of the 
task space. 
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SEQ=ERR 


A command was entered out of sequence. Task was not loaded 
when a BUILD command was entered. 


SICGCNON REQUIRED 


Attempt to enter a command before signon or a mistake in the 
SIGNON command. 


SRLPHKERR 


An attempt was made to skip beyond the end of a CSS job. 


SPAC@ERR 


Task exceeds established maximum System Space. 


SVC ADDRESS ERROR-INSTRUCTICN AT XXXXXX 
SVC FARAMETER BLOCK AT XXXXXX 


Incorrect address of SVC parameter block at xxxxxx. The SVC 
parameter block must be on a fullvord boundary. 


SVC6“ERR TYPE=ARGS 


There is insufficient room between UTOP and CTOP td contain 
the start option string. 


SVC6-ERR TYPE=DORM 


A command was issued to a specified task that is dormant. 


SVC6“ERR TYPE=NMSG 


The task currently executing at the terminal could not 
receive a message trape 


SV¥VC6-ERR TYPES=PRES 


The Spooler was not loaded when it was requested. 


SVC6-ERR TYPE=QUE 


Spooler is dormant. 
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TASK=ERR 


A task-related command was entered and there is no currently 
loaded task. 


TLOe-ERe 


A task cannot be loaded because the user account CPU limit 
expired. 


UNDEFINED DATA FORMAT FAULT AT XXXXXX 
MEMORY FAULT ADDRESS=XXXXXX 


An undefined data format/alignment fault was detected at 
xxxxxx for Perkin-Elmer 3200 Series machines. 


USER=ERR 


An invalid userid was entered in a MESSAGE command. 


VOLN-ERR 


The volume specified is not online or the volume name is 
invalid. 


xxxx ERROR ON fd SECTOR or 
An I/O error occurred while attempting to initialize sector 


n of file fd. Xxxxx is the type of error: it may be 
unrecoverable I/0, recoverable I/Q, or device unavailable. 
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APPENDIX E 
CSS MESSAGE SUMMARY 


BUFF-ERR 
indicates an expanded command line exceeds the CSS buffer. 
The task skips to STERMJOB. 

FD-ERR 
indicates not enough space to build an fd, or required file 
Support is not in system. The task skips to STERMJOB. 

FORM-ERE 
indicates a command syntax is invalid. The task skips to 
STERMJOB. 

GOTO-ERR 
indicates a SLABEL occurred inside an IF block that was not 
active at the time cf the $GOTO commande. The task skips to 
STERMJOB. 

I/O-ERR 
indicates an EOF was found while skipping to SENDC, an _ EOF 
was found before a SENDB while building a file, or a STERMJOB 
was found while skipping to SENDC within a job. The task 
skips to STERMJOB, or end of task code is 255 and job is 
ended. 


JOBS<ERR 


indicates a second $JOB was found. 
LVL=ERR 


indicates the CSS levels required exceed the number 
established at sysgen time. 
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AAEM-ERR 


indicates the command entered is not recognized. The task 
skips to STERMJOB. 


PARM~ERR 


indicates a command was entered with invalid or missing 
Parameters. 


SEQ~ERR 


indicates a command was entered out of sequence. 


TASK@ERR 


indicates a task-related command was entered and there is no 
currently loaded task. The task skiscs to STERMJOB. 


@SYSXXXX VARIAPLE ERROR, ILLEGAL NAME 
indicates that a variable was defined beginning with the 


reserved characters a@SYS or an attempt was made to free a 
system variable. 


O@XXXX-VARIABLE ERROR, ALREADY EXISTS 


indicates an attempt was made to define a local variable that 
already exists. 


O@XXXX-VARIABLE ERROR, EXCEEDS USER LIMIT 


indicates that the variable Limit set at sysgen was exceeded. 


@XXXX-VARIABLE ERROR, DEFINITION TOC LONG 


indicates that the length of the defined variable is greater 
than 32. 


O@XXXX-VARIABLE ERROR, DOES NOT EXIST 


indicates an attempt to set or free the value of a 
nonexistent variable. Also, during CSS execution, a variable 
definition is required. 
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@XXXX-VARIABLE ERROR, DEFINITION DOES NOT EXIST 


indicates an attempt to set the value of a variable to the 
value of a second nonexistent variable. 


@SYSCODE-VAPIABLE ERROR, UNABLE TO ACCESS PAGE-FILE 


indicates that at sSignon time MIM was unable to access the 
Variable page file. 


VARIABLE ERROR, VARIABLE PROCESSING NOT SUPPORTED 


indicates that one of the following variable related commands 
was entered into a system that does not support variable 
processing: 


= SPREE 

- SGLOBAL 
- $LOCAL 
= S$5SE7 


VARIABLE ERROR, VARIABLE PRCCESSING DISABLED 


indicates that one of the following variable related commands 
was entered into a system with variable processing support 
that is disabled; 


* JSFREE 

- SGLOBAL 
- SLOCAL 
= Soir 
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APPENDIX F 
PROGRAM DEVELOPMENT MESSAGE SUMMARY 


ALTERNATE CSS REQUIRED 


The fd entered with the ADD command contains a nonstandard 
extension, and the cssprod parameter was not specified. 


COMPILE ERROR - LINK NOT EXECUTED 


In a complink process, a compilation error was found, and the 
process aborted before the link procedure began. 


COMPILE ERRORS, LISTING ON PR: 


Frrors were encountered while compiling. These errors are 
listed on the specified prs. 


CURRENT ENVIRONMENT - filename 


The ENV command, entered without a filename, causes the name 
of the current environment to be displayed. 


CURRENT PROGRAM NOT SET 


A filename was not specified, or no current program exists. 


EDIT - filename.eext 


In the multi-module environment, the EDIT command was entered 
without a filename. The fd of the current source program is 
displayed. 


ENVIRONMENT EMPTY 


The LIST command was entered, but there are no file 
descriptors in the EDF. 


EXTENSION OMITTED 


A filename entered with the ADD or REMOVE command did not 
contain the required extension. 
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exe 
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x* 
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** 


x ® 


ex 


EXECUTICN OF filename FOLLOWS: 


An image program is loaded and is executing. 


FILE fd NOT FOUND 


The specified filename cannot be found in the language 
environment. 


fd NONEXISTENT 


A specified fd does not exist in the environment. 


FILENAME CONFLICT - ENTRY NOT ADDED 


An attempt was made to add an already existing fd to the EDF. 


FILENAME NOT IN ENVIRONMENT 


An fd specified with the REMOVE command does not exist in the 
EDF. 


LANGUAGE ENVIRONMENT NOT SET 


A development command such as EDIT, COMPILE, COMPLINK, or 
EXEC was entered without first setting the Language 
environment. 


LINK ERRORS - EXECUTION ABORTED 


Program execution aborted when a link error was encountered 


NEW ENVIRONMENT 


An empty EDF has been allocated. 


NEW PROGRAM 


An empty source file is allocated in the language 
environment. 


NO CURRENT EDF 


The ENV command was entered without an EDF name, or there is 
no current EDF. 


48-043 FOG ROO 


x«* 


x 


“x2 


4g- 


NON-STANDARD EXTENSION 


An attempt was made to add an £d with a nonstandard language 
extension to the EDF without specifying a cssprod parameter. 


NOT IN MULTI-MODULE ENVIRONMENT 


A command that is only meaningful in a multi-module 
environment was specified in a language environment. 


SOURCE FILE NOT FOUND 


The specified source file cannot be found. 


SYNTAX ERRCR 


An fd was not specified with the ADD or REMOVE command. 


TASK fd NOT FOUND 


The specified task cannct not be found. 


TOO MANY ARGUMENTS 


Arguments were specified in a multi-module environment. 
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